mirror of
https://github.com/Shu-Ying/noname-shuying.git
synced 2026-10-24 08:39:58 +08:00
fixed # 归档
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
# Pause Point Author Subagent
|
||||
|
||||
## Responsibilities
|
||||
|
||||
Design only the places where the user genuinely must choose, plus cross-device recovery. First distinguish four categories: user decision, automatic handling, stop condition, and manual handoff. Create a user pause only when two or more valid options change scope, behavior, accepted risk, or an irreversible outcome. Execute a sole safe action directly, report a missing dependency or corrupt state as a stop condition, and return control for a manual handoff. Genuine user decisions cannot be bypassed by defaults, historical preferences, or automatic advancement.
|
||||
|
||||
Must cover:
|
||||
|
||||
- `reference/decision-points.md`
|
||||
- `reference/recovery.md`
|
||||
|
||||
## Inputs
|
||||
|
||||
Read the common input from the main session, especially:
|
||||
|
||||
- `confirm-generate`, `revise-proposal`, and `cancel` from the Skill Creator confirmation page: these are user decisions that change the generated result.
|
||||
- Eval workload (`skip / quick / full eval`) and human approval before installation: treat them as decisions only when multiple valid options actually remain.
|
||||
- Missing or stale eval evidence, unresolved candidates, ambiguity, capability gaps, and executable disclosures: classify each as automatically repairable, a no-path stop condition, or a real decision with multiple recovery choices. Do not turn all blockers into pause points.
|
||||
- Runner recovery state and cross-device recovery entry: reuse persisted choices that remain valid instead of asking again on resume.
|
||||
|
||||
Use file handoff: the main session provides paths instead of pasting large bodies of text. Do not inherit main-session history; use only this brief, common input, workflow protocol, and existing drafts.
|
||||
|
||||
## Dispatch Template
|
||||
|
||||
Dispatch a fresh subagent for this role with:
|
||||
|
||||
```text
|
||||
description: "Design user pause points and recovery for <bundle-name>"
|
||||
prompt:
|
||||
You are the pause point author subagent.
|
||||
First read this brief, the common input path, workflow protocol path, Skill draft path, and report file path.
|
||||
First classify each candidate as a user decision, automatic handling, stop condition, or manual handoff. If facts needed for classification are missing, return NEEDS_CONTEXT.
|
||||
Do not guess missing choices, and do not disguise automatic repair, guard failure, capability gaps, a sole valid action, or manual handoff as a user pause.
|
||||
Only produce decision-points and recovery drafts; do not write Bundle state and do not execute candidate scripts.
|
||||
Write the full pause point draft to the report file path and return only a status summary of 15 lines or fewer.
|
||||
```
|
||||
|
||||
## Output Requirements
|
||||
|
||||
Return a classification table first, then describe genuine user pause points:
|
||||
|
||||
- Which category each candidate belongs to and the evidence for that classification.
|
||||
- The trigger condition for every pause point.
|
||||
- The choices available to the user.
|
||||
- Which Node each choice enters.
|
||||
- Where pause point evidence is written.
|
||||
- How automatic handling advances directly, and how stop conditions report recovery requirements without inventing options.
|
||||
- During recovery, how to show the current Node, blocking reason, suggested next step, and real options while reusing persisted choices.
|
||||
|
||||
Pause points must fit the current workflow protocol, not merely list original Comet pause points.
|
||||
|
||||
## Self-Check
|
||||
|
||||
Before returning, check:
|
||||
|
||||
- Every user pause point has trigger condition, options, next Node, and evidence location.
|
||||
- Every pause has at least two currently executable valid options; adjacent choices that can be answered together are merged, and a sole valid value creates no pause.
|
||||
- Guard failures, deterministic retries, state reconciliation, capability gaps, and `NEXT: manual` are classified according to their actual semantics instead of defaulting to user questions.
|
||||
- Default recommendations, historical preferences, and automatic advancement cannot bypass required pause points.
|
||||
- The recovery summary can show the current Node, blocking reason, suggested next step, and real options without re-asking choices that remain valid.
|
||||
- Cross-device recovery does not rely on current-session memory.
|
||||
- Pause points fit the current composed Skill instead of copying original Comet pause points.
|
||||
|
||||
## Required Claims
|
||||
|
||||
- `pause:decision-points`
|
||||
- `pause:recovery`
|
||||
|
||||
Missing any claim must block Skill review.
|
||||
|
||||
## Status Return
|
||||
|
||||
Status must be one of `DONE`, `DONE_WITH_CONCERNS`, `NEEDS_CONTEXT`, or `BLOCKED`.
|
||||
|
||||
Write the full report to the report file path. The summary returned to the main session must be 15 lines or fewer and include status, report path, claims, unresolved concerns, and recovery risks. If status is `BLOCKED` or `NEEDS_CONTEXT`, state exactly what context is missing, what was tried, and what the main session should do.
|
||||
@@ -0,0 +1,74 @@
|
||||
# Reference Author Subagent
|
||||
|
||||
## Responsibilities
|
||||
|
||||
Write and organize the generated Skill's reference layer so audit, recovery, review, and future maintenance have real evidence. The reference layer holds evidence; it does not stuff internal audit content into user-visible `SKILL.md`.
|
||||
|
||||
Must cover:
|
||||
|
||||
- `reference/workflow-protocol.json`
|
||||
- `reference/resolved-skills.json`
|
||||
- `reference/composition-report.md`
|
||||
- `reference/authoring-lanes.json`
|
||||
|
||||
## Inputs
|
||||
|
||||
Read the common input from the main session, especially:
|
||||
|
||||
- Resolved Skill name, source, description, hash, references, rules, scripts, and hooks.
|
||||
- `sourceSummaries`, which must come from real `SKILL.md` bodies and direct references.
|
||||
- Project preferences, missing or ambiguous candidate handling, deviation reasons, and executable disclosures.
|
||||
- The five-phase Comet semantics preserved when users customize `/comet-classic`.
|
||||
|
||||
Use file handoff: the main session provides paths instead of pasting large bodies of text. Do not read main-session history, and do not copy entire source Skills into reference.
|
||||
|
||||
## Dispatch Template
|
||||
|
||||
Dispatch a fresh subagent for this role with:
|
||||
|
||||
```text
|
||||
description: "Organize reference evidence for <bundle-name>"
|
||||
prompt:
|
||||
You are the reference author subagent.
|
||||
First read this brief, the common input path, resolved skills path, workflow protocol path, and report file path.
|
||||
Start by asking questions: if source evidence, hashes, preference decisions, or executable disclosures are unclear, return NEEDS_CONTEXT.
|
||||
Do not guess or fill in missing sources.
|
||||
Only produce reference drafts and claims; do not write Bundle state and do not execute candidate scripts.
|
||||
Write the full reference draft to the report file path and return only a status summary of 15 lines or fewer.
|
||||
```
|
||||
|
||||
## Output Requirements
|
||||
|
||||
Return a reference draft that explains:
|
||||
|
||||
- Each workflow protocol Node's goal, guard, next-Node condition, and recovery point.
|
||||
- How resolved Skill evidence supports the composed flow.
|
||||
- Where composition matches user preferences, where it deviates, and why.
|
||||
- Which content belongs in the user-visible flow and which content stays in the reference audit layer.
|
||||
|
||||
Do not turn reference into copied source Skill prose. Distill it into evidence and protocol that the composed Skill can use.
|
||||
|
||||
## Self-Check
|
||||
|
||||
Before returning, check:
|
||||
|
||||
- Every source summary traces back to a real `SKILL.md` or direct reference.
|
||||
- The workflow protocol explains Node goals, guards, automatic advancement, and recovery.
|
||||
- Preferences, missing candidates, ambiguity, deviations, and executable disclosures are recorded.
|
||||
- User-visible flow and internal audit content have a clear boundary.
|
||||
- No source Skill body was copied wholesale into reference.
|
||||
|
||||
## Required Claims
|
||||
|
||||
- `reference:workflow-protocol`
|
||||
- `reference:resolved-skills`
|
||||
- `reference:composition-report`
|
||||
- `reference:authoring-lanes`
|
||||
|
||||
Missing any claim must block Skill review.
|
||||
|
||||
## Status Return
|
||||
|
||||
Status must be one of `DONE`, `DONE_WITH_CONCERNS`, `NEEDS_CONTEXT`, or `BLOCKED`.
|
||||
|
||||
Write the full report to the report file path. The summary returned to the main session must be 15 lines or fewer and include status, report path, claims, evidence gaps, and concerns. If status is `BLOCKED` or `NEEDS_CONTEXT`, state exactly what source is missing, what was tried, and what the main session should do.
|
||||
@@ -0,0 +1,78 @@
|
||||
# Script Author Subagent
|
||||
|
||||
## Responsibilities
|
||||
|
||||
Design the generated Skill's script contract instead of copying Comet Classic scripts. Scripts must use the current workflow protocol, user-selected Node labels, and real composed Skill outputs to define automatic advancement, exit checks, recovery, and evidence recording.
|
||||
|
||||
Must cover:
|
||||
|
||||
- `scripts/workflow-state.mjs`
|
||||
- `scripts/workflow-guard.mjs`
|
||||
- `scripts/workflow-handoff.mjs`
|
||||
|
||||
The factory also deterministically generates `scripts/comet-plan.mjs`, `scripts/comet-check.mjs`, and `scripts/comet-hook-guard.mjs` from the same `workflow-protocol.json`. Do not duplicate or redesign those three; your contract is for the `workflow-*.mjs` scripts that the Skill core author and entry author reference.
|
||||
|
||||
## Inputs
|
||||
|
||||
Read the common input from the main session, especially:
|
||||
|
||||
- `reference/workflow-protocol.json`
|
||||
- `workflow.kind`, `workflow.nodes`, `engineMode`, and `runnerMode` from `plan.json`, plus the
|
||||
derived internal `callChain` source inventory from Skill Creator metadata
|
||||
- `reference/resolved-skills.json`
|
||||
- Protected `.comet.yaml` semantics when users customize `/comet-classic`; `comet-five-phase-overlay` primary state comes only from `<classic-change-dir>/.comet.yaml` bound by the Classic layout resolver and must not create `.comet/runs/<workflow>/state.json` as the Comet overlay primary state.
|
||||
|
||||
Use file handoff: the main session provides paths instead of pasting large bodies of text. Do not read main-session history or ask the user to restate content already written to artifacts.
|
||||
|
||||
## Dispatch Template
|
||||
|
||||
Dispatch a fresh subagent for this role with:
|
||||
|
||||
```text
|
||||
description: "Write the script contract for <bundle-name>"
|
||||
prompt:
|
||||
You are the script author subagent.
|
||||
First read this brief, the common input path, workflow protocol path, resolved skills path, and report file path.
|
||||
Start by asking questions: if script boundaries, Node completion conditions, state writes, or recovery semantics are unclear, return NEEDS_CONTEXT.
|
||||
Do not guess or fill in missing protocol details.
|
||||
Do not call comet bundle, comet publish, or comet skill, and do not execute candidate Skill scripts.
|
||||
Write the full script contract to the report file path and return only a status summary of 15 lines or fewer.
|
||||
```
|
||||
|
||||
## Output Requirements
|
||||
|
||||
Return a script contract draft that explains, for each script:
|
||||
|
||||
- Which state it reads.
|
||||
- Which state and evidence it writes.
|
||||
- How it decides whether the current Node goal is complete.
|
||||
- How it outputs `NEXT:`, `SKILL:`, and blocking reasons.
|
||||
- How it stays in the current Node when the Node is incomplete instead of forcing an exit.
|
||||
- How it supports cross-device recovery.
|
||||
- For `comet-five-phase-overlay`, how it blocks when there is no active change or multiple active changes and asks the user to choose.
|
||||
|
||||
Exit checks must come from the current workflow protocol and composed Skill goal, not copied Comet Classic scripts.
|
||||
|
||||
## Self-Check
|
||||
|
||||
Before returning, check:
|
||||
|
||||
- Every script has inputs, outputs, state reads/writes, evidence writes, and failure behavior.
|
||||
- Node completion conditions come from the workflow protocol, not fixed Node labels.
|
||||
- `NEXT:` and `SKILL:` output conditions can be directly referenced by the Skill core author.
|
||||
- Cross-device recovery does not rely on current-session memory.
|
||||
- No candidate script was executed and no Bundle state was written.
|
||||
|
||||
## Required Claims
|
||||
|
||||
- `script:workflow-state`
|
||||
- `script:workflow-guard`
|
||||
- `script:workflow-handoff`
|
||||
|
||||
Missing any claim must block Skill review.
|
||||
|
||||
## Status Return
|
||||
|
||||
Status must be one of `DONE`, `DONE_WITH_CONCERNS`, `NEEDS_CONTEXT`, or `BLOCKED`.
|
||||
|
||||
Write the full report to the report file path. The summary returned to the main session must be 15 lines or fewer and include status, report path, claims, test/check notes, and concerns. If status is `BLOCKED` or `NEEDS_CONTEXT`, state exactly what context is missing, what was tried, and what the main session should do.
|
||||
@@ -0,0 +1,126 @@
|
||||
# Skill Core Author Subagent
|
||||
|
||||
## Responsibilities
|
||||
|
||||
Write the user-visible core content for internal Node Skills. The entry Skill is owned separately by the workflow entry author. The goal is a Comet-like multi-Node workflow, not a simple chain of source Skills or a copied source Skill body.
|
||||
|
||||
Must cover:
|
||||
|
||||
- Every internal Node Skill
|
||||
- Node invocation semantics in `comet/skill.yaml`
|
||||
- Every `node-skill:<skill-name>` claim
|
||||
|
||||
## Authored Zone (what you write)
|
||||
|
||||
The generator composes each Node SKILL.md from a deterministic **Auto zone** (frontmatter, Node Goal, Entry Check, Skill Implementation, Required Skill Calls, Output Schemas, Evidence Record, Guardrails, Exit Check, Recovery) plus an **Authored zone** (`## Guidance`) that YOU write. You do NOT write the whole file — only the Guidance body. The main session records your output via `comet creator authoring-record <name> --lane skill-core --file <out.json>`; the artifact `content` for `../<node-skill>/SKILL.md` is the Guidance body.
|
||||
|
||||
Quality bar: a real Comet phase skill (e.g. `comet-build/SKILL.md`); see `reference/authored-zone-example.md` for a full sample at the expected level. Author decision content, not boilerplate. Use `###` subsections within Guidance so they nest under `## Guidance`:
|
||||
|
||||
- `### Prerequisites` — what must be true before this Node starts.
|
||||
- `### Steps` — the ordered, domain-specific steps; reference the bound Skill by name and say when to call it (do not copy its body).
|
||||
- `### Completion reasoning` — when the Node is genuinely done (beyond the mechanical Exit Check), and the judgment calls involved.
|
||||
- `### Red flags` — the failure modes that look like progress but are not.
|
||||
|
||||
Here is a concrete excerpt showing the expected depth for a "Research" substance node. Notice: it is **decision content** (when to stop, what counts as enough, what to reject), not a restatement of the route table or output schema.
|
||||
|
||||
```markdown
|
||||
### Prerequisites
|
||||
|
||||
- The entry Decision Core has confirmed the research topic and scope.
|
||||
- `research-skill` is resolvable in the project Skill pool; if missing, stop and ask the user before improvising.
|
||||
|
||||
### Steps
|
||||
|
||||
1. Load `research-skill` and follow its discovery method for the confirmed topic. Do not substitute a generic web search when the project Skill defines a specific source order.
|
||||
2. Gather sources in priority order; for each source, capture origin, date, and the claim you will reuse. Reject sources that fail the project's credibility bar rather than noting them as "weak".
|
||||
3. Distill findings into note files under `notes/*.md` — one note per distinct claim, with a verbatim quote and the source pointer. Synthesis happens in the writer node, not here.
|
||||
4. Record the `research.notes.v1` `summary` evidence with a one-paragraph distillation and the count of notes produced.
|
||||
|
||||
### Completion reasoning
|
||||
|
||||
This node is complete ONLY when both hold: (a) the `summary` evidence is recorded, and (b) at least one artifact matches `notes/*.md`. Do not exit merely because the step list is exhausted — if notes are sparse relative to the topic scope, continue researching rather than declaring done. The Exit Check script enforces the artifact + evidence requirement mechanically; your job is to judge whether the research is genuinely sufficient.
|
||||
|
||||
### Red flags
|
||||
|
||||
- Exiting after recording `summary` but producing zero `notes/*.md` files (the guardrail will block this — do not attempt to bypass).
|
||||
- Copying source text into notes without a quote marker or source pointer.
|
||||
- Advancing to the Write node while a source is still "to be verified" — verification belongs in this node.
|
||||
- Treating a single source as sufficient for a multi-perspective topic.
|
||||
```
|
||||
|
||||
Node mode (from the protocol):
|
||||
|
||||
- **substance** Node (workflow-kernel default): rich Guidance is mandatory. Without it the Node renders as `AUTHORING PENDING` and the Bundle cannot become ready.
|
||||
- **delegates** Node (comet-five-phase-overlay, delegating to an installed rich Skill): a short Guidance note is acceptable — the delegate carries the richness; do not duplicate it.
|
||||
|
||||
## Inputs
|
||||
|
||||
Read the common input from the main session, especially:
|
||||
|
||||
- User-confirmed Node labels and editable name fields.
|
||||
- Node goals, `requiredSkillCalls`, and automatic advancement conditions from
|
||||
`reference/workflow-protocol.json`.
|
||||
- Real Skill summaries from `reference/resolved-skills.json`.
|
||||
- The script author's `NEXT:`, `SKILL:`, guard, and recovery contracts.
|
||||
|
||||
Use file handoff: the main session provides paths instead of pasting large bodies of text. Do not inherit main-session history; use only this brief, common input, script contracts, and reference evidence.
|
||||
|
||||
## Dispatch Template
|
||||
|
||||
Dispatch a fresh subagent for this role with:
|
||||
|
||||
```text
|
||||
description: "Write Skill core content for <bundle-name>"
|
||||
prompt:
|
||||
You are the Skill core author subagent.
|
||||
First read this brief, the common input path, script contract path, reference evidence path, and report file path.
|
||||
Start by asking questions: if Node labels, required Skill calls, automatic advancement, or user pause points are unclear, return NEEDS_CONTEXT.
|
||||
Do not guess or fill in missing flow details.
|
||||
Only write internal Node Skill drafts; do not write entry Skill, Bundle state, or execute candidate scripts.
|
||||
Write the full Skill draft to the report file path and return only a status summary of 15 lines or fewer.
|
||||
```
|
||||
|
||||
## Output Requirements
|
||||
|
||||
Return internal Node Skill drafts that show:
|
||||
|
||||
- Internal Node Skills own a single-Node goal, required Skill calls, completion evidence, and script guards.
|
||||
- If the protocol declares `requiredSkillCalls`, the matching Node must state the target Node,
|
||||
required Skill, applies-to scope, and evidence requirement. Subagent cases must also tell the
|
||||
implementation subagent prompt to load that Skill.
|
||||
- If the Node goal is not complete, continue working instead of exiting because a checklist is exhausted.
|
||||
- Automatic advancement must come from script outputs `NEXT:` and `SKILL:`, not agent guesses.
|
||||
- Nested Skill calls use only Skill names, not provider prefixes.
|
||||
- When users customize `/comet-classic`, preserve `open / design / build / verify / archive` and `.comet.yaml` semantics.
|
||||
- For arbitrary Skill composition, organize the result as a Comet-like multi-Node workflow.
|
||||
|
||||
Forbidden:
|
||||
|
||||
- Copying full source Skill bodies.
|
||||
- Provider prefixes such as `Superpowers writing-plans` or `OpenSpec openspec-propose`.
|
||||
- Mixing Chinese process sentences into English Skills.
|
||||
- Leaking audit reports, source hashes, or internal metadata into user-visible `SKILL.md`.
|
||||
|
||||
## Self-Check
|
||||
|
||||
Before returning, check:
|
||||
|
||||
- Every Node explains required Skill calls, completion evidence, script guards, and recovery entry.
|
||||
- Every `requiredSkillCalls` item has a clear load instruction and evidence requirement in the
|
||||
matching Node Skill.
|
||||
- Automatic advancement references script outputs `NEXT:` and `SKILL:`.
|
||||
- Skill calls use only Skill names, not provider prefixes.
|
||||
- User-visible English prose does not mix in Chinese process sentences.
|
||||
- No source Skill body was copied wholesale.
|
||||
|
||||
## Required Claims
|
||||
|
||||
- One `node-skill:<skill-name>` for every internal Node Skill
|
||||
|
||||
Missing any claim must block Skill review.
|
||||
|
||||
## Status Return
|
||||
|
||||
Status must be one of `DONE`, `DONE_WITH_CONCERNS`, `NEEDS_CONTEXT`, or `BLOCKED`.
|
||||
|
||||
Write the full report to the report file path. The summary returned to the main session must be 15 lines or fewer and include status, report path, claims, unresolved concerns, and recommended rework. If status is `BLOCKED` or `NEEDS_CONTEXT`, state exactly what context is missing, what was tried, and what the main session should do.
|
||||
@@ -0,0 +1,123 @@
|
||||
# Skill Review Subagent
|
||||
|
||||
## Responsibilities
|
||||
|
||||
Review the other subagents' artifacts and claims, then decide whether the candidate Skill is usable like Comet. The review must give a clear conclusion: `Review passed` or blocking findings.
|
||||
|
||||
Must cover:
|
||||
|
||||
- `reference/skill-review.md`
|
||||
- `reference/authoring-lanes.json`
|
||||
|
||||
## Inputs
|
||||
|
||||
Read the common input from the main session, plus all artifacts, claims, and findings returned by the other five author roles.
|
||||
|
||||
Use file handoff: the main session provides paths instead of pasting large bodies of text. Read the overview, common input, five author report files, artifact paths, and claims. Do not use main-session history as a substitute for artifact evidence.
|
||||
|
||||
## Dispatch Template
|
||||
|
||||
Dispatch a fresh subagent for this role with:
|
||||
|
||||
```text
|
||||
description: "Review the Comet-like Skill outputs for <bundle-name>"
|
||||
prompt:
|
||||
You are the Skill review subagent.
|
||||
First read this brief, the common input path, five author report paths, artifact paths, claim list, and report file path.
|
||||
Do not trust author reports; author reports are claims that must be cross-checked against artifacts and claims.
|
||||
Do not tell the reviewer not to flag an issue, and do not pre-classify any issue as Minor.
|
||||
Review is read-only. Do not modify the working tree, index, HEAD, or branch state.
|
||||
Write the full review to the report file path and return both verdicts.
|
||||
```
|
||||
|
||||
## Review Method
|
||||
|
||||
Do not trust author reports. Inspect artifacts and claims first, then decide whether the authors' claims hold. Do not downgrade severity because "the author says this is intentional."
|
||||
|
||||
The review must provide two verdicts:
|
||||
|
||||
- Skill contract fit: whether the output satisfies the user-confirmed goal, workflow protocol,
|
||||
`requiredSkillCalls`, claims, Node advancement, script guards, pause points, and recovery
|
||||
requirements.
|
||||
- Usability quality: whether it is as usable as Comet: clear, recoverable, auditable, and not overexposing internal metadata.
|
||||
|
||||
Evidence must cite artifact paths and claims. Do not write only "looks fine."
|
||||
|
||||
## Blocking Conditions
|
||||
|
||||
Any of these must produce blocking findings:
|
||||
|
||||
- Missing `reference/skill-review.md`.
|
||||
- Missing `reference/authoring-lanes.json`.
|
||||
- Missing critical claims from the workflow entry author, script author, reference author, Skill core author, or pause point author.
|
||||
- Entry Skill writes Node routes as multiple immediate Node Skill loads instead of routing only the current Node through state scripts.
|
||||
- Missing `workflow-state.mjs`, `workflow-guard.mjs`, or `workflow-handoff.mjs` contract.
|
||||
- Missing any of the six generated scripts (`workflow-state`, `workflow-guard`, `workflow-handoff`, `comet-plan`, `comet-check`, `comet-hook-guard`) in the package.
|
||||
- Missing workflow entry, or Skill core has no internal Node Skill.
|
||||
- Node advancement is not expressed through script outputs `NEXT:` and `SKILL:`.
|
||||
- `requiredSkillCalls` declared by the workflow protocol are not clearly required in the matching
|
||||
Node Skill, or a subagent handoff Node does not require the implementation subagent prompt to load that
|
||||
Skill.
|
||||
- User pause points are missing, or can be bypassed by defaults.
|
||||
- Deterministic repair, guard failure, state reconciliation, a capability gap, a sole valid action, or `NEXT: manual` is treated as a user pause by default; or adjacent choices that can be answered together are split into serial confirmations.
|
||||
- The entry Skill frontmatter description does not identify it as the managed workflow entry/resume router, or an internal Node Skill description allows ordinary tasks to trigger it without explicit invocation or entry/runtime routing.
|
||||
- English Skills mix in Chinese process sentences.
|
||||
- Nested Skill calls use provider prefixes.
|
||||
- User-visible `SKILL.md` leaks generated audit sections, source hashes, or internal metadata.
|
||||
- Customizing `/comet-classic` replaces or removes `open / design / build / verify / archive`, `.comet.yaml`, decision point, verify-result-transition, or archive-delta-sync.
|
||||
- Arbitrary Skill composition is missing automatic advancement, script guards, user pause points, recovery, or current draft hash eval evidence.
|
||||
|
||||
## Severity
|
||||
|
||||
- Critical: makes the generated Skill unusable, unrecoverable, unauditable, or breaks protected `/comet-classic` semantics.
|
||||
- Important: makes the Node flow, script guards, pause points, Skill calls, or evidence chain untrustworthy; must be fixed before ready.
|
||||
- Minor: clarity, naming, or maintainability improvements that do not block ready.
|
||||
|
||||
## Output Requirements
|
||||
|
||||
Return:
|
||||
|
||||
- `reference/skill-review.md`
|
||||
- `reference/authoring-lanes.json`
|
||||
- `review:skill-review`
|
||||
- Final `Review passed` or blocking findings.
|
||||
|
||||
Output must include:
|
||||
|
||||
- Two verdicts: Skill contract fit and usability quality.
|
||||
- Strengths: concrete artifacts that work well.
|
||||
- Issues grouped by Critical, Important, and Minor.
|
||||
- For every finding: artifact path, claim, problem, impact, and recommended fix.
|
||||
- `Review passed` or blocking findings.
|
||||
|
||||
If any Critical or Important issue exists, do not return `Review passed`. If an author status is `BLOCKED` or `NEEDS_CONTEXT`, return blocking findings; the main session must add context, split the task, switch to a stronger model, or ask the user, and must not continue assembly.
|
||||
|
||||
## Multi-vote Review (depth-aware)
|
||||
|
||||
The skill-review lane is the DAG barrier and runs after every author lane. Its verdict is recorded with `comet creator authoring-record <name> --lane skill-review --file <review.json>` and becomes the real `skill-review.md` / `authoring-lanes.json` evidence — it is NOT a hardcoded approval.
|
||||
|
||||
- `depth: full` → dispatch N=3 independent reviewers, each holding exactly one lens (`contract-fit`, `usability`, `evidence-trace`, `self-consistency`), none seeing the others' conclusions. Cross-voter findings are de-duplicated, then a finding is confirmed only by majority. Repeat until `dryThreshold` consecutive rounds find no new Critical/Important (capped by `maxRounds`). `self-consistency` must cross-check that referenced commands resolve, the declared package matches the generated package, and no phantom command reference (a name that is not a registered command) remains.
|
||||
- `depth: quick` → a single reviewer, single round.
|
||||
- `passed` is `true` only when zero Critical/Important findings remain. Minor findings are recorded but do not block.
|
||||
|
||||
The recorded review object must match this shape (validated by `authoring-record`):
|
||||
|
||||
```json
|
||||
{
|
||||
"lane": "skill-review",
|
||||
"status": "DONE",
|
||||
"review": {
|
||||
"passed": true,
|
||||
"evidenceSource": "llm-multivote",
|
||||
"voters": 3,
|
||||
"lenses": ["contract-fit", "usability", "evidence-trace", "self-consistency"],
|
||||
"rounds": 2,
|
||||
"findings": [
|
||||
{ "severity": "minor", "path": "SKILL.md", "problem": "Wording nit.", "fix": "Rephrase." }
|
||||
],
|
||||
"reviewedAt": "2026-06-28T00:00:00.000Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
A `passed: false` review is a readiness blocker (publish cannot proceed); a missing review is a warning (the package still carries an honest `deterministic-check-only` placeholder, never a fabricated approval).
|
||||
@@ -0,0 +1,98 @@
|
||||
# Workflow Entry Author Subagent
|
||||
|
||||
## Responsibilities
|
||||
|
||||
Write the generated Skill's entry `SKILL.md`. The entry owns the entry point, recovery, main router explanation, and user pause points; it must not turn the Node route table into an execution checklist that immediately triggers multiple Skills.
|
||||
|
||||
Must cover:
|
||||
|
||||
- entry Skill
|
||||
- Entry guidance for workflow-state / workflow-guard / workflow-handoff
|
||||
- `workflow-entry` claim
|
||||
|
||||
## Authored Zone (what you write)
|
||||
|
||||
The generator composes the entry SKILL.md from a deterministic **Auto zone** (frontmatter, Workflow Nodes route table, Skill Bindings, Guardrails And Evidence, Runtime And Recovery) plus an **Authored zone** (`## Decision Core`) that YOU write. You do NOT write the whole file — only the Decision Core body. The main session records your output via `comet creator authoring-record <name> --lane workflow-entry --file <out.json>`; the artifact `content` for `SKILL.md` is the Decision Core body.
|
||||
|
||||
Quality bar: the `comet/SKILL.md` Decision Core (see `reference/authored-zone-example.md` for a full entry Decision Core example at the expected level). Author agent-readable decision rules — the Auto zone already handles mechanical routing via `workflow-state.mjs next`, so focus on judgment:
|
||||
|
||||
- **Semantic current-Node detection** — how to determine which Node the user is in, beyond just running the script. Model comet's Step 0 (detect intent from user message, check Node order, handle "belongs to earlier/later Node" conflicts) + Step 1 (read state, trust files over stale state).
|
||||
- **Resume and drift rules** — what to do when context resumes (re-detect from scratch, never trust conversation history), when state says DONE but artifacts are missing, when the user's topic shifts mid-Node.
|
||||
- **Decision classification and decision points** — first distinguish user decisions, automatic handling, stop conditions, and manual handoffs, then tabulate only genuine user choices. A clear first invocation, an objectively repairable guard failure, a sole valid next action, and `NEXT: manual` must not manufacture confirmation.
|
||||
- **Red flags** — the "agent thought → actual risk" pattern that catches self-deception (e.g., "user mentioned the topic so research is confirmed" → mentioning ≠ confirming).
|
||||
|
||||
A Decision Core without these four sections is a stub, not a Decision Core. The entry is the most-loaded file — it is what makes the Skill feel intelligent or mechanical.
|
||||
|
||||
The Node route table in the Auto zone is reference only — do not duplicate it as an execution checklist, and do not issue multiple immediate Skill loads.
|
||||
|
||||
## Inputs
|
||||
|
||||
Read the common input from the main session, especially:
|
||||
|
||||
- The user-confirmed goal, language, and Node labels.
|
||||
- Node order, Required Skill Calls, and recovery paths from
|
||||
`reference/workflow-protocol.json`.
|
||||
- The script author's `status`, `init`, `next`, `NEXT:`, `SKILL:`, and guard contracts.
|
||||
- The open / design / build / verify / archive boundary that must be preserved when users customize `/comet-classic`.
|
||||
|
||||
Use file handoff: the main session provides paths instead of pasting large bodies of text. Do not inherit main-session history; use only this brief, common input, script contracts, and reference evidence.
|
||||
|
||||
## Dispatch Template
|
||||
|
||||
Dispatch a fresh subagent for this role with:
|
||||
|
||||
```text
|
||||
description: "Write the workflow entry for <bundle-name>"
|
||||
prompt:
|
||||
You are the workflow entry author subagent.
|
||||
First read this brief, the common input path, script contract path, workflow protocol path, and report file path.
|
||||
First classify user decisions, automatic handling, stop conditions, and manual handoffs. If startup routing, recovery paths, current-Node detection, or genuine user choices are unclear, return NEEDS_CONTEXT.
|
||||
Do not guess or fill in missing flow details.
|
||||
Only write the entry SKILL.md draft; do not write internal Node Skills, Bundle state, or execute candidate scripts.
|
||||
The Decision Core MUST include four subsections: ### Automatic Node Detection (Step 0 intent detection + Step 1 state read + resume rules), ### Decision Classification And Decision Points (genuine user choices only), ### Red Flags (agent thought → actual risk table). Do not list guard failures, deterministic repair, a sole valid action, or manual handoff as a user decision. A Decision Core without these is a stub.
|
||||
Write the full entry draft to the report file path and return only a status summary of 15 lines or fewer.
|
||||
```
|
||||
|
||||
## Output Requirements
|
||||
|
||||
The entry draft must show:
|
||||
|
||||
- On entry, first read workflow state instead of directly loading a Node Skill.
|
||||
- If not started, initialize state before querying `next`.
|
||||
- Only after scripts output `NEXT: auto` and `SKILL: <node-skill>` should the agent load that single Node Skill.
|
||||
- The Node route table is reference only; it must not use "immediately execute" or "must load" execution directives.
|
||||
- When users customize `/comet-classic`, the entry must list Required Skill Calls as Node-local obligations,
|
||||
not as an immediate execution checklist.
|
||||
- User decisions, automatic handling, stop conditions, manual handoffs, recovery paths, and reference files are visible. Pause only when at least two real valid options remain, and merge adjacent choices.
|
||||
- When users customize `/comet-classic`, preserve the open / design / build / verify / archive main path and Guardrails.
|
||||
|
||||
Forbidden:
|
||||
|
||||
- Multiple `**Immediate:**` or `**Execute now:**` generated Node Skill loads in entry `SKILL.md`.
|
||||
- Copying full source Skill bodies.
|
||||
- Provider prefixes.
|
||||
- Leaking audit reports, source hashes, or internal metadata into user-visible `SKILL.md`.
|
||||
|
||||
## Self-Check
|
||||
|
||||
Before returning, check:
|
||||
|
||||
- The Decision Core has all four required subsections: Automatic Node Detection, Decision Points, Red Flags, and either Error Handling or Resume Rules.
|
||||
- The entry has exactly one main router startup protocol.
|
||||
- The entry has no immediate-load checklist for Node Skills.
|
||||
- The Node route is reference, not execution steps.
|
||||
- Automatic advancement references script outputs `NEXT:` and `SKILL:`.
|
||||
- A clear first invocation initializes directly, guard failures are diagnosed automatically or reported as stop conditions, and `NEXT: manual` only returns control; none is presented as a fabricated user decision.
|
||||
- User-visible English prose is consistent and does not mix in Chinese process sentences.
|
||||
|
||||
## Required Claim
|
||||
|
||||
- `workflow-entry`
|
||||
|
||||
Missing this claim must block Skill review.
|
||||
|
||||
## Status Return
|
||||
|
||||
Status must be one of `DONE`, `DONE_WITH_CONCERNS`, `NEEDS_CONTEXT`, or `BLOCKED`.
|
||||
|
||||
Write the full report to the report file path. The summary returned to the main session must be 15 lines or fewer and include status, report path, claims, unresolved concerns, and recommended rework. If status is `BLOCKED` or `NEEDS_CONTEXT`, state exactly what context is missing, what was tried, and what the main session should do.
|
||||
Reference in New Issue
Block a user