@rpamis/comet 0.4.0-beta.12 → 0.4.0-beta.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/manifest.json +15 -1
- package/assets/skills/comet/SKILL.md +5 -11
- package/assets/skills/comet/reference/comet-yaml-fields.md +1 -1
- package/assets/skills/comet/reference/context-recovery.md +3 -3
- package/assets/skills/comet/reference/decision-point.md +4 -5
- package/assets/skills/comet/reference/scripts.md +17 -47
- package/assets/skills/comet/reference/subagent-dispatch.md +8 -8
- package/assets/skills/comet/rules/comet-phase-guard.en.md +2 -2
- package/assets/skills/comet/rules/comet-phase-guard.md +2 -2
- package/assets/skills/comet/scripts/comet-archive.mjs +165 -2
- package/assets/skills/comet/scripts/comet-entry-runtime.mjs +146 -8071
- package/assets/skills/comet/scripts/comet-guard.mjs +207 -2
- package/assets/skills/comet/scripts/comet-handoff.mjs +165 -2
- package/assets/skills/comet/scripts/comet-hook-guard.mjs +151 -2
- package/assets/skills/comet/scripts/comet-hook-router.mjs +155 -12101
- package/assets/skills/comet/scripts/comet-intent.mjs +10 -2
- package/assets/skills/comet/scripts/comet-resume-probe.mjs +148 -2
- package/assets/skills/comet/scripts/comet-runtime.mjs +286 -19170
- package/assets/skills/comet/scripts/comet-state.mjs +164 -2
- package/assets/skills/comet/scripts/comet-yaml-validate.mjs +149 -2
- package/assets/skills/comet-archive/SKILL.md +1 -1
- package/assets/skills/comet-build/SKILL.md +13 -14
- package/assets/skills/comet-classic/SKILL.md +9 -9
- package/assets/skills/comet-design/SKILL.md +4 -4
- package/assets/skills/comet-hotfix/SKILL.md +2 -2
- package/assets/skills/comet-native/SKILL.md +17 -2
- package/assets/skills/comet-native/reference/commands.md +12 -0
- package/assets/skills/comet-native/reference/recovery.md +2 -0
- package/assets/skills/comet-native/scripts/comet-native-archive.mjs +178 -0
- package/assets/skills/comet-native/scripts/comet-native-check.mjs +173 -0
- package/assets/skills/comet-native/scripts/comet-native-checkpoint.mjs +179 -0
- package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +207 -0
- package/assets/skills/comet-native/scripts/comet-native-evidence.mjs +151 -0
- package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +150 -2
- package/assets/skills/comet-native/scripts/comet-native-init.mjs +171 -0
- package/assets/skills/comet-native/scripts/comet-native-new.mjs +200 -0
- package/assets/skills/comet-native/scripts/comet-native-next.mjs +182 -0
- package/assets/skills/comet-native/scripts/comet-native-receipt.mjs +179 -0
- package/assets/skills/comet-native/scripts/comet-native-root.mjs +185 -0
- package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +227 -31299
- package/assets/skills/comet-native/scripts/comet-native-select.mjs +178 -0
- package/assets/skills/comet-native/scripts/comet-native-show.mjs +151 -0
- package/assets/skills/comet-native/scripts/comet-native-spec.mjs +181 -0
- package/assets/skills/comet-native/scripts/comet-native-status.mjs +175 -0
- package/assets/skills/comet-tweak/SKILL.md +2 -2
- package/assets/skills/comet-verify/SKILL.md +3 -3
- package/assets/skills-zh/comet/SKILL.md +5 -11
- package/assets/skills-zh/comet/reference/comet-yaml-fields.md +1 -1
- package/assets/skills-zh/comet/reference/context-recovery.md +3 -3
- package/assets/skills-zh/comet/reference/decision-point.md +4 -5
- package/assets/skills-zh/comet/reference/scripts.md +9 -39
- package/assets/skills-zh/comet/reference/subagent-dispatch.md +8 -8
- package/assets/skills-zh/comet-archive/SKILL.md +1 -1
- package/assets/skills-zh/comet-build/SKILL.md +13 -14
- package/assets/skills-zh/comet-classic/SKILL.md +7 -7
- package/assets/skills-zh/comet-design/SKILL.md +5 -5
- package/assets/skills-zh/comet-hotfix/SKILL.md +2 -2
- package/assets/skills-zh/comet-native/SKILL.md +17 -2
- package/assets/skills-zh/comet-native/reference/commands.md +12 -0
- package/assets/skills-zh/comet-native/reference/recovery.md +2 -0
- package/assets/skills-zh/comet-tweak/SKILL.md +2 -2
- package/assets/skills-zh/comet-verify/SKILL.md +3 -3
- package/bin/comet.js +5 -1
- package/bin/fast-runtime-router.js +82 -0
- package/dist/app/cli/index.js +57 -18
- package/dist/app/cli/index.js.map +1 -1
- package/dist/app/commands/dashboard.js +2 -2
- package/dist/app/commands/dashboard.js.map +1 -1
- package/dist/app/commands/i18n.d.ts +1 -1
- package/dist/app/commands/i18n.d.ts.map +1 -1
- package/dist/app/commands/i18n.js +10 -0
- package/dist/app/commands/i18n.js.map +1 -1
- package/dist/app/commands/init.d.ts.map +1 -1
- package/dist/app/commands/init.js +9 -5
- package/dist/app/commands/init.js.map +1 -1
- package/dist/app/commands/uninstall.d.ts.map +1 -1
- package/dist/app/commands/uninstall.js +150 -8
- package/dist/app/commands/uninstall.js.map +1 -1
- package/dist/app/commands/update.d.ts +1 -0
- package/dist/app/commands/update.d.ts.map +1 -1
- package/dist/app/commands/update.js +166 -24
- package/dist/app/commands/update.js.map +1 -1
- package/dist/config/repository-layout.json +33 -3
- package/dist/domains/comet-classic/classic-archive-entry.js +1 -1
- package/dist/domains/comet-classic/classic-archive-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-branch-binding.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-branch-binding.js +8 -2
- package/dist/domains/comet-classic/classic-branch-binding.js.map +1 -1
- package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-current-change.js +6 -1
- package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
- package/dist/domains/comet-classic/classic-guard-entry.js +1 -1
- package/dist/domains/comet-classic/classic-guard-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-guard.js +1 -1
- package/dist/domains/comet-classic/classic-guard.js.map +1 -1
- package/dist/domains/comet-classic/classic-handoff-entry.js +1 -1
- package/dist/domains/comet-classic/classic-handoff-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-hook-guard-entry.js +1 -1
- package/dist/domains/comet-classic/classic-hook-guard-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-hook-guard.js +7 -4
- package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
- package/dist/domains/comet-classic/classic-intent-entry.js +1 -1
- package/dist/domains/comet-classic/classic-intent-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-layout-initialization.js +18 -11
- package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -1
- package/dist/domains/comet-classic/classic-layout.d.ts +7 -4
- package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-layout.js +9 -9
- package/dist/domains/comet-classic/classic-layout.js.map +1 -1
- package/dist/domains/comet-classic/classic-resume-probe-entry.js +1 -1
- package/dist/domains/comet-classic/classic-resume-probe-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-script-entry.d.ts +2 -2
- package/dist/domains/comet-classic/classic-script-entry.d.ts.map +1 -1
- package/dist/domains/comet-classic/classic-script-entry.js +4 -3
- package/dist/domains/comet-classic/classic-script-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-state-command.js +6 -6
- package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
- package/dist/domains/comet-classic/classic-state-entry.js +1 -1
- package/dist/domains/comet-classic/classic-state-entry.js.map +1 -1
- package/dist/domains/comet-classic/classic-validate-entry.js +1 -1
- package/dist/domains/comet-classic/classic-validate-entry.js.map +1 -1
- package/dist/domains/comet-entry/entry-reads.d.ts +17 -0
- package/dist/domains/comet-entry/entry-reads.d.ts.map +1 -0
- package/dist/domains/comet-entry/entry-reads.js +20 -0
- package/dist/domains/comet-entry/entry-reads.js.map +1 -0
- package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-router-entry.js +3 -1
- package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
- package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
- package/dist/domains/comet-entry/hook-router.js +8 -3
- package/dist/domains/comet-entry/hook-router.js.map +1 -1
- package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
- package/dist/domains/comet-entry/init-workflow.js +7 -8
- package/dist/domains/comet-entry/init-workflow.js.map +1 -1
- package/dist/domains/comet-entry/resolve-entry.d.ts.map +1 -1
- package/dist/domains/comet-entry/resolve-entry.js +3 -4
- package/dist/domains/comet-entry/resolve-entry.js.map +1 -1
- package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
- package/dist/domains/comet-entry/resume-probe.js +16 -5
- package/dist/domains/comet-entry/resume-probe.js.map +1 -1
- package/dist/domains/comet-native/native-archive-command.d.ts +3 -0
- package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-archive-command.js +49 -0
- package/dist/domains/comet-native/native-archive-command.js.map +1 -0
- package/dist/domains/comet-native/native-archive-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-archive-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-archive-entry.js +4 -0
- package/dist/domains/comet-native/native-archive-entry.js.map +1 -0
- package/dist/domains/comet-native/native-check-command.d.ts +3 -0
- package/dist/domains/comet-native/native-check-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-check-command.js +30 -0
- package/dist/domains/comet-native/native-check-command.js.map +1 -0
- package/dist/domains/comet-native/native-check-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-check-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-check-entry.js +4 -0
- package/dist/domains/comet-native/native-check-entry.js.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-command.d.ts +3 -0
- package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-command.js +39 -0
- package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-checkpoint-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-checkpoint-entry.js +4 -0
- package/dist/domains/comet-native/native-checkpoint-entry.js.map +1 -0
- package/dist/domains/comet-native/native-cli-shared.d.ts +40 -0
- package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -0
- package/dist/domains/comet-native/native-cli-shared.js +272 -0
- package/dist/domains/comet-native/native-cli-shared.js.map +1 -0
- package/dist/domains/comet-native/native-cli.d.ts +2 -5
- package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
- package/dist/domains/comet-native/native-cli.js +37 -785
- package/dist/domains/comet-native/native-cli.js.map +1 -1
- package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
- package/dist/domains/comet-native/native-continuation.js +16 -0
- package/dist/domains/comet-native/native-continuation.js.map +1 -1
- package/dist/domains/comet-native/native-doctor-command.d.ts +3 -0
- package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-doctor-command.js +29 -0
- package/dist/domains/comet-native/native-doctor-command.js.map +1 -0
- package/dist/domains/comet-native/native-doctor-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-doctor-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-doctor-entry.js +4 -0
- package/dist/domains/comet-native/native-doctor-entry.js.map +1 -0
- package/dist/domains/comet-native/native-evidence-command.d.ts +3 -0
- package/dist/domains/comet-native/native-evidence-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-evidence-command.js +35 -0
- package/dist/domains/comet-native/native-evidence-command.js.map +1 -0
- package/dist/domains/comet-native/native-evidence-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-evidence-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-evidence-entry.js +4 -0
- package/dist/domains/comet-native/native-evidence-entry.js.map +1 -0
- package/dist/domains/comet-native/native-evidence-storage.d.ts +17 -6
- package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
- package/dist/domains/comet-native/native-evidence-storage.js +89 -23
- package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
- package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
- package/dist/domains/comet-native/native-findings.js +18 -0
- package/dist/domains/comet-native/native-findings.js.map +1 -1
- package/dist/domains/comet-native/native-hook-guard-command.d.ts +3 -0
- package/dist/domains/comet-native/native-hook-guard-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-hook-guard-command.js +32 -0
- package/dist/domains/comet-native/native-hook-guard-command.js.map +1 -0
- package/dist/domains/comet-native/native-hook-guard-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-hook-guard-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-hook-guard-entry.js +4 -0
- package/dist/domains/comet-native/native-hook-guard-entry.js.map +1 -0
- package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
- package/dist/domains/comet-native/native-hook-guard.js +7 -1
- package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
- package/dist/domains/comet-native/native-init-command.d.ts +3 -0
- package/dist/domains/comet-native/native-init-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-init-command.js +29 -0
- package/dist/domains/comet-native/native-init-command.js.map +1 -0
- package/dist/domains/comet-native/native-init-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-init-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-init-entry.js +4 -0
- package/dist/domains/comet-native/native-init-entry.js.map +1 -0
- package/dist/domains/comet-native/native-new-command.d.ts +3 -0
- package/dist/domains/comet-native/native-new-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-new-command.js +35 -0
- package/dist/domains/comet-native/native-new-command.js.map +1 -0
- package/dist/domains/comet-native/native-new-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-new-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-new-entry.js +4 -0
- package/dist/domains/comet-native/native-new-entry.js.map +1 -0
- package/dist/domains/comet-native/native-next-command.d.ts +3 -0
- package/dist/domains/comet-native/native-next-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-next-command.js +82 -0
- package/dist/domains/comet-native/native-next-command.js.map +1 -0
- package/dist/domains/comet-native/native-next-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-next-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-next-entry.js +4 -0
- package/dist/domains/comet-native/native-next-entry.js.map +1 -0
- package/dist/domains/comet-native/native-receipt-command.d.ts +3 -0
- package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-receipt-command.js +107 -0
- package/dist/domains/comet-native/native-receipt-command.js.map +1 -0
- package/dist/domains/comet-native/native-receipt-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-receipt-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-receipt-entry.js +4 -0
- package/dist/domains/comet-native/native-receipt-entry.js.map +1 -0
- package/dist/domains/comet-native/native-receipt-refresh.d.ts +86 -0
- package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -0
- package/dist/domains/comet-native/native-receipt-refresh.js +232 -0
- package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -0
- package/dist/domains/comet-native/native-root-command.d.ts +3 -0
- package/dist/domains/comet-native/native-root-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-root-command.js +29 -0
- package/dist/domains/comet-native/native-root-command.js.map +1 -0
- package/dist/domains/comet-native/native-root-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-root-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-root-entry.js +4 -0
- package/dist/domains/comet-native/native-root-entry.js.map +1 -0
- package/dist/domains/comet-native/native-script-entry.d.ts +12 -0
- package/dist/domains/comet-native/native-script-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-script-entry.js +44 -0
- package/dist/domains/comet-native/native-script-entry.js.map +1 -0
- package/dist/domains/comet-native/native-select-command.d.ts +3 -0
- package/dist/domains/comet-native/native-select-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-select-command.js +15 -0
- package/dist/domains/comet-native/native-select-command.js.map +1 -0
- package/dist/domains/comet-native/native-select-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-select-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-select-entry.js +4 -0
- package/dist/domains/comet-native/native-select-entry.js.map +1 -0
- package/dist/domains/comet-native/native-show-command.d.ts +3 -0
- package/dist/domains/comet-native/native-show-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-show-command.js +41 -0
- package/dist/domains/comet-native/native-show-command.js.map +1 -0
- package/dist/domains/comet-native/native-show-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-show-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-show-entry.js +4 -0
- package/dist/domains/comet-native/native-show-entry.js.map +1 -0
- package/dist/domains/comet-native/native-snapshot.d.ts +9 -0
- package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
- package/dist/domains/comet-native/native-snapshot.js +141 -5
- package/dist/domains/comet-native/native-snapshot.js.map +1 -1
- package/dist/domains/comet-native/native-spec-command.d.ts +3 -0
- package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-spec-command.js +34 -0
- package/dist/domains/comet-native/native-spec-command.js.map +1 -0
- package/dist/domains/comet-native/native-spec-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-spec-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-spec-entry.js +4 -0
- package/dist/domains/comet-native/native-spec-entry.js.map +1 -0
- package/dist/domains/comet-native/native-status-command.d.ts +3 -0
- package/dist/domains/comet-native/native-status-command.d.ts.map +1 -0
- package/dist/domains/comet-native/native-status-command.js +36 -0
- package/dist/domains/comet-native/native-status-command.js.map +1 -0
- package/dist/domains/comet-native/native-status-entry.d.ts +2 -0
- package/dist/domains/comet-native/native-status-entry.d.ts.map +1 -0
- package/dist/domains/comet-native/native-status-entry.js +4 -0
- package/dist/domains/comet-native/native-status-entry.js.map +1 -0
- package/dist/domains/comet-native/native-transitions.d.ts +4 -0
- package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
- package/dist/domains/comet-native/native-transitions.js +28 -4
- package/dist/domains/comet-native/native-transitions.js.map +1 -1
- package/dist/domains/comet-native/native-types.d.ts +8 -0
- package/dist/domains/comet-native/native-types.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +14 -0
- package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.js +29 -1
- package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -1
- package/dist/domains/comet-native/native-verification-runtime.d.ts +28 -1
- package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
- package/dist/domains/comet-native/native-verification-runtime.js +92 -14
- package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
- package/dist/domains/dashboard/collector.d.ts.map +1 -1
- package/dist/domains/dashboard/collector.js +53 -41
- package/dist/domains/dashboard/collector.js.map +1 -1
- package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
- package/dist/domains/dashboard/native-collector.js +13 -3
- package/dist/domains/dashboard/native-collector.js.map +1 -1
- package/dist/domains/dashboard/project-directory.d.ts +20 -0
- package/dist/domains/dashboard/project-directory.d.ts.map +1 -0
- package/dist/domains/dashboard/project-directory.js +87 -0
- package/dist/domains/dashboard/project-directory.js.map +1 -0
- package/dist/domains/dashboard/project-root.d.ts +8 -0
- package/dist/domains/dashboard/project-root.d.ts.map +1 -0
- package/dist/domains/dashboard/project-root.js +68 -0
- package/dist/domains/dashboard/project-root.js.map +1 -0
- package/dist/domains/dashboard/server.d.ts +1 -0
- package/dist/domains/dashboard/server.d.ts.map +1 -1
- package/dist/domains/dashboard/server.js +50 -10
- package/dist/domains/dashboard/server.js.map +1 -1
- package/dist/domains/dashboard/web/assets/{arc-BXDAG6Qx.js → arc-mNt_SS1l.js} +1 -1
- package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-Bc5akVD6.js +36 -0
- package/dist/domains/dashboard/web/assets/{blockDiagram-GPEHLZMM-STNPWdDl.js → blockDiagram-GPEHLZMM-C43zhVBe.js} +2 -2
- package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-Bh-rUIcJ.js → c4Diagram-AAUBKEIU-dToETarK.js} +2 -2
- package/dist/domains/dashboard/web/assets/channel-b2wWDG4F.js +1 -0
- package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-BRhFNAFH.js → chunk-2J33WTMH-C0oO137R.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-CwA3zkFS.js → chunk-4BX2VUAB-CGms1fgI.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-C1tqAl_E.js → chunk-55IACEB6-Bugl8v6f.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-DDefBoUS.js → chunk-727SXJPM-8ATNMlBG.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-AQP2D5EJ-Dq-0Yi9D.js → chunk-AQP2D5EJ-BNYjSSqU.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-DC-MVNgk.js → chunk-FMBD7UC4-_nJAqSbe.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-BLWZ8zWd.js → chunk-ND2GUHAM-lyxYm5NX.js} +1 -1
- package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-DaK5rvZu.js → chunk-QZHKN3VN-PUMVeWpd.js} +1 -1
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-B9SWZywo.js +1 -0
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-B9SWZywo.js +1 -0
- package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-DzMqjexn.js +1 -0
- package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-CBaY4KFj.js → cynefin-VYW2F7L2-B67ET0eq.js} +1 -1
- package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-CQPMvRLK.js +4 -0
- package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-BRpLrFHM.js +43 -0
- package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-CPGWuGrE.js +10 -0
- package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-BZcengGf.js → diagram-KO2AKTUF-D2wpX2iO.js} +2 -2
- package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-D54mAbDu.js +24 -0
- package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-ZGQDpSs_.js +24 -0
- package/dist/domains/dashboard/web/assets/{erDiagram-TEJ5UH35-BBrwULhs.js → erDiagram-TEJ5UH35-C3qDo7sd.js} +2 -2
- package/dist/domains/dashboard/web/assets/{flowDiagram-I6XJVG4X-DiNn0Yzp.js → flowDiagram-I6XJVG4X-B7hStPd9.js} +2 -2
- package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-IqcLFbTK.js +292 -0
- package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-YrMZpzUu.js +106 -0
- package/dist/domains/dashboard/web/assets/index-DhtBssCt.js +257 -0
- package/dist/domains/dashboard/web/assets/{index-QO0z6F4w.js → index-icxk8_BP.js} +1 -1
- package/dist/domains/dashboard/web/assets/index-pr3axVDI.css +1 -0
- package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-CcIgGK_7.js +2 -0
- package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-DCPPspol.js → ishikawaDiagram-YF4QCWOH-1x3rNjGP.js} +2 -2
- package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-C_v8b1Os.js → journeyDiagram-JHISSGLW-B2XiqMNP.js} +2 -2
- package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-CgpE9lG7.js → kanban-definition-UN3LZRKU-x46cGuo3.js} +2 -2
- package/dist/domains/dashboard/web/assets/{linear-jSddcREx.js → linear-DFLqGZWl.js} +1 -1
- package/dist/domains/dashboard/web/assets/{mermaid.core-5Ibr28Ig.js → mermaid.core-g3J6BACc.js} +69 -69
- package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-XPCohX0x.js → mindmap-definition-RKZ34NQL-CTdeKmcX.js} +2 -2
- package/dist/domains/dashboard/web/assets/{pieDiagram-4H26LBE5-DvhxgQWl.js → pieDiagram-4H26LBE5-C_obwjIf.js} +2 -2
- package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CCUxdF-S.js → quadrantDiagram-W4KKPZXB-B6Gnfz9M.js} +4 -4
- package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-FS3TCmdX.js → requirementDiagram-4Y6WPE33-nX4PObnB.js} +2 -2
- package/dist/domains/dashboard/web/assets/{sankeyDiagram-5OEKKPKP-r129rscN.js → sankeyDiagram-5OEKKPKP-QjDwwHgl.js} +2 -2
- package/dist/domains/dashboard/web/assets/{sequenceDiagram-3UESZ5HK--DCY0bvU.js → sequenceDiagram-3UESZ5HK-BEEe0j6B.js} +2 -2
- package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-CXfAaBgM.js +1 -0
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-CD3nS4cC.js +1 -0
- package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-NlqCuFuo.js → timeline-definition-PNZ67QCA-BOzX2EnD.js} +2 -2
- package/dist/domains/dashboard/web/assets/{vennDiagram-CIIHVFJN-B4W_d1Nq.js → vennDiagram-CIIHVFJN-C40vhXRq.js} +2 -2
- package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-Bex-_jWd.js → wardleyDiagram-YWT4CUSO-B1rm89JH.js} +2 -2
- package/dist/domains/dashboard/web/assets/{xychartDiagram-2RQKCTM6-CmxeVM2Z.js → xychartDiagram-2RQKCTM6-BlMr59qK.js} +2 -2
- package/dist/domains/dashboard/web/index.html +2 -2
- package/dist/domains/integrations/openspec.d.ts +1 -0
- package/dist/domains/integrations/openspec.d.ts.map +1 -1
- package/dist/domains/integrations/openspec.js +6 -0
- package/dist/domains/integrations/openspec.js.map +1 -1
- package/dist/domains/skill/platform-install.d.ts.map +1 -1
- package/dist/domains/skill/platform-install.js +4 -6
- package/dist/domains/skill/platform-install.js.map +1 -1
- package/dist/domains/skill/uninstall.d.ts +6 -2
- package/dist/domains/skill/uninstall.d.ts.map +1 -1
- package/dist/domains/skill/uninstall.js +128 -19
- package/dist/domains/skill/uninstall.js.map +1 -1
- package/dist/domains/workflow-contract/project-config.d.ts +1 -0
- package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
- package/dist/domains/workflow-contract/project-config.js +45 -1
- package/dist/domains/workflow-contract/project-config.js.map +1 -1
- package/dist/platform/install/detect.d.ts +1 -0
- package/dist/platform/install/detect.d.ts.map +1 -1
- package/dist/platform/install/detect.js +2 -0
- package/dist/platform/install/detect.js.map +1 -1
- package/dist/platform/process/hook-read-cache.d.ts +45 -0
- package/dist/platform/process/hook-read-cache.d.ts.map +1 -0
- package/dist/platform/process/hook-read-cache.js +102 -0
- package/dist/platform/process/hook-read-cache.js.map +1 -0
- package/dist/platform/version/version.d.ts.map +1 -1
- package/dist/platform/version/version.js +9 -2
- package/dist/platform/version/version.js.map +1 -1
- package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +2 -0
- package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +2 -0
- package/eval/local/tasks/comet-native-workflow/instruction.md +3 -3
- package/eval/local/tasks/comet-native-workflow/task.toml +4 -2
- package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +212 -75
- package/eval/local/tests/scaffold/test_native_wave_evaluations.py +114 -39
- package/eval/local/tests/scaffold/test_tasks.py +5 -1
- package/package.json +7 -3
- package/dist/domains/dashboard/web/assets/_commonjsHelpers-CqkleIqs.js +0 -1
- package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-R2JyCv0i.js +0 -36
- package/dist/domains/dashboard/web/assets/channel-XR_5gd6D.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-CG_TnucZ.js +0 -1
- package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-CG_TnucZ.js +0 -1
- package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-DCPgAyMU.js +0 -1
- package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-CLKQ6BQM.js +0 -4
- package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-DCup336F.js +0 -43
- package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-DgpDOFTE.js +0 -10
- package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-DSECilBo.js +0 -24
- package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-3FuzANXW.js +0 -24
- package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-DcvbTHnu.js +0 -292
- package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-CgCY3MJo.js +0 -106
- package/dist/domains/dashboard/web/assets/index-BR3wUr2k.css +0 -1
- package/dist/domains/dashboard/web/assets/index-CovQUq5W.js +0 -24
- package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-hzBGAEue.js +0 -2
- package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-yHkUByrT.js +0 -1
- package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-XHzDdqcm.js +0 -1
|
@@ -29,7 +29,7 @@ Streamlined OpenSpec artifacts must use the configured Comet artifact language.
|
|
|
29
29
|
|
|
30
30
|
Execution chain: open → OpenSpec apply → verify → archive. Tweak provides default decisions for each phase: streamlined open, direct build through OpenSpec apply, scale- and delta-spec-driven verification weight, and final archive confirmation after verification passes.
|
|
31
31
|
|
|
32
|
-
Before starting,
|
|
32
|
+
Before starting, use `comet/reference/scripts.md` to run the public Comet CLI command. When resuming from any entry point, first use `comet/reference/context-recovery.md` to check phase/workflow.
|
|
33
33
|
|
|
34
34
|
When resuming an existing tweak change, the first state operation must be `comet state select <change-name>`. For a new change, run the command immediately after `.comet.yaml` initialization and before source writes.
|
|
35
35
|
|
|
@@ -156,7 +156,7 @@ Exception: when `.comet.yaml` has `auto_transition: false`, end the current invo
|
|
|
156
156
|
|
|
157
157
|
The following genuine user decisions still pause:
|
|
158
158
|
|
|
159
|
-
1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **
|
|
159
|
+
1. Encountering an upgrade-assessment signal (see "Upgrade Assessment" section). **Pause, present the choices, and wait for the user to explicitly choose**: continue the tweak lightweight flow, or upgrade to the full `/comet-classic` workflow
|
|
160
160
|
2. Verify-phase acceptance of WARNING/SUGGESTION deviations, Spec drift handling, or strategy after the automatic repair limit; the first 3 clearly repairable failures close automatically
|
|
161
161
|
3. Final archive confirmation and the branch-handling decision after the archive commit
|
|
162
162
|
|
|
@@ -63,7 +63,7 @@ comet state get <change-name> plan
|
|
|
63
63
|
git diff --stat <base-ref read from plan frontmatter>...HEAD
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
-
The first command returns the plan path. Use the
|
|
66
|
+
The first command returns the plan path. Use the file-reading tool to parse the single `base-ref` frontmatter field, validate it as a commit, then substitute it into the second command. Do not depend on POSIX text pipelines.
|
|
67
67
|
|
|
68
68
|
If commit range shows changes exceed lightweight threshold (> 8 files, cross-module coordination, or delta spec spans more than 1 capability), manually set to full verification:
|
|
69
69
|
|
|
@@ -173,7 +173,7 @@ comet state transition <change-name> verify-fail
|
|
|
173
173
|
```
|
|
174
174
|
|
|
175
175
|
**Spec Drift Handling** (user decision point):
|
|
176
|
-
- If check item 6 finds contradictions (delta spec has content but design doc does not reflect it), **
|
|
176
|
+
- If check item 6 finds contradictions (delta spec has content but design doc does not reflect it), **pause, present the handling methods as a single-select question, and wait for the user to choose**; must not select automatically. Options:
|
|
177
177
|
- Option A: Append "Implementation Divergence" section to design doc recording deviation reason. Option A is a verify phase allowed artifact; after writing, must not re-trigger Step 1b dirty-worktree decision due to that design doc change
|
|
178
178
|
- Option B: After user selects B, run `comet state transition <change-name> verify-fail`, then invoke `/comet-build`; `/comet-build`'s Spec Incremental Update rules will load the Superpowers `brainstorming` skill to update Design Doc + delta spec
|
|
179
179
|
- Option C: Confirm deviation is acceptable, continue verification (design doc will be marked as `superseded-by-main-spec` during archiving)
|
|
@@ -186,7 +186,7 @@ Save the verification report and record it in `.comet.yaml`. Do not handle, merg
|
|
|
186
186
|
comet state set <change-name> verification_report docs/superpowers/reports/YYYY-MM-DD-<change-name>-verify.md
|
|
187
187
|
```
|
|
188
188
|
|
|
189
|
-
Use the
|
|
189
|
+
Use the file tool to create `docs/superpowers/reports/` and the report file; do not depend on a POSIX-only directory command.
|
|
190
190
|
|
|
191
191
|
## Exit Conditions
|
|
192
192
|
|
|
@@ -7,23 +7,17 @@ description: "当用户明确调用 /comet,或明确要求使用 Comet 但未
|
|
|
7
7
|
|
|
8
8
|
`/comet` 只负责选择入口,不包含任何一种工作流的执行方法。
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
一旦加载本 Skill,就视为已经选定 `/comet` 入口。必须立即执行下方入口解析,不得重新判断任务是否适合 Comet,也不得只解释为什么不使用它。
|
|
11
11
|
|
|
12
|
-
1.
|
|
12
|
+
1. 在当前项目运行 PATH 中安装的 Comet CLI:
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
15
|
comet workflow resolve . --json
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
node <comet-skill-root>/scripts/comet-entry-runtime.mjs . --json
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
CLI 已启动但返回非零、配置解析失败、输出不是 JSON 或字段无效,都不得使用 bundled runtime 重试;停止并原样说明错误,不要回退或猜测。
|
|
25
|
-
3. 解析 JSON。只接受 `schema: comet.workflow-resolution.v1`,且 `skill` 必须是下列两个值之一。
|
|
26
|
-
4. 只按返回的 `skill` 选择下列一个入口。必须立即使用 Skill 工具加载且只加载该入口:
|
|
18
|
+
若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整。不得搜索 Skill 文件、扫描平台配置目录或直接调用内部 bundle。CLI 已启动但返回非零、配置解析失败、输出不是 JSON 或字段无效时,同样停止并原样说明错误,不要回退或猜测。
|
|
19
|
+
2. 解析 JSON。只接受 `schema: comet.workflow-resolution.v1`,且 `skill` 必须是下列两个值之一。
|
|
20
|
+
3. 只按返回的 `skill` 选择下列一个入口。必须立即使用 Skill 工具加载且只加载该入口:
|
|
27
21
|
- `/comet-native` → **立即执行:** 使用 Skill 工具加载 `comet-native` 技能。禁止跳过此步骤。
|
|
28
22
|
- `/comet-classic` → **立即执行:** 使用 Skill 工具加载 `comet-classic` 技能。禁止跳过此步骤。
|
|
29
23
|
|
|
@@ -44,7 +44,7 @@ archived: false
|
|
|
44
44
|
| `base_ref` | init 时记录的 git commit SHA,用于 scale 评估。无 plan 时作为改动文件数统计基准 |
|
|
45
45
|
| `build_mode` | 已选择的执行方式,可为空。取值:`subagent-driven-development`(隔离后台 subagent 逐任务实现并审查)、`executing-plans`(主会话按计划顺序执行)、`direct`(主会话直接编码,默认仅 hotfix/tweak 允许,full workflow 需 `direct_override: true`) |
|
|
46
46
|
| `build_pause` | build 阶段内部暂停点。`null` 表示无暂停,`plan-ready` 表示 plan 已生成,用户选择切换模型后暂停 |
|
|
47
|
-
| `subagent_dispatch` | `null` 或 `confirmed
|
|
47
|
+
| `subagent_dispatch` | `null` 或 `confirmed`。`confirmed` 记录用户已选择 `subagent-driven-development`;该模式只有带此记录时才能离开 build 阶段 |
|
|
48
48
|
| `tdd_mode` | `tdd` 或 `direct`。full workflow 离开 build 阶段前必须已选择。`tdd` 强制每个任务先写失败测试再实现;`direct` 不强制逐任务 TDD,但仍需相关测试与 bug 回归证据。hotfix/tweak 默认 `direct` |
|
|
49
49
|
| `review_mode` | `off`、`standard` 或 `thorough`。full workflow 离开 build 阶段前必须已选择;hotfix/tweak 默认 `off` |
|
|
50
50
|
| `isolation` | `current`、`branch` 或 `worktree`。full 初始化可为 `null`,离开 build 前必须由用户显式选择 `current`、实际创建/选择 `branch`,或实际创建/选择 `worktree`;hotfix/tweak 在入口用户决策点后也可如实使用三种模式,不得在未创建分支时虚构为 `branch` |
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
## 任意入口恢复原则
|
|
8
8
|
|
|
9
|
-
用户可能直接从 `/comet-open`、`/comet-design`、`/comet-build`、`/comet-verify`、`/comet-archive`、`/comet-hotfix` 或 `/comet-tweak` 回到流程。进入任意子 Skill 时,都先按 `comet/reference/scripts.md`
|
|
9
|
+
用户可能直接从 `/comet-open`、`/comet-design`、`/comet-build`、`/comet-verify`、`/comet-archive`、`/comet-hotfix` 或 `/comet-tweak` 回到流程。进入任意子 Skill 时,都先按 `comet/reference/scripts.md` 运行公开 CLI 命令,再用当前子 Skill 对应 phase 运行入口检查或恢复检查。不得依赖对话历史判断阶段。
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
12
|
comet state check <change-name> <phase> --recover
|
|
@@ -16,10 +16,10 @@ comet state check <change-name> <phase> --recover
|
|
|
16
16
|
|
|
17
17
|
## 未显式 `/comet-classic` 的恢复
|
|
18
18
|
|
|
19
|
-
如果用户没有提 `/comet-classic`,但本仓库可能有 active Classic change,开始处理需要改动或调查的任务前先运行 Ambient Resume
|
|
19
|
+
如果用户没有提 `/comet-classic`,但本仓库可能有 active Classic change,开始处理需要改动或调查的任务前先运行 Ambient Resume 探针。按 `comet/reference/scripts.md` 运行公开 CLI 命令,然后把当前用户请求从 stdin 传入:
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
|
|
22
|
+
comet resume-probe . --stdin --json
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
只有返回 `auto_resume` 才自动恢复;`ask_user` 必须短问用户;`out_of_scope` 和 `none` 不进入 workflow。
|
|
@@ -13,14 +13,13 @@
|
|
|
13
13
|
- **停止条件**:依赖缺失、状态损坏、路径越界或外部命令不可用,导致当前没有合法下一步;报告阻塞原因和恢复条件,不得伪造选项
|
|
14
14
|
- **手动衔接**:`NEXT: manual` 只是交还控制权,不是新的用户决策点;输出 `HINT` 后结束当前调用,不再询问“是否继续”
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
只有第一类使用本协议。相邻且可同时回答的选择必须合并;已经持久化且仍有效的选择不得重复询问。不得因预判后续工具或操作可能失败而预检、推断或筛除选项。展示本工作流支持的全部选择;用户选择后执行对应动作,若失败则停止并报告原错误。若某字段只剩一个工作流合法值,说明原因后直接采用,不为它单独创建停顿点。
|
|
17
17
|
|
|
18
18
|
## 核心规则
|
|
19
19
|
|
|
20
20
|
- 决策点是阻塞点。到达决策点时必须暂停,等待用户明确选择后才能继续
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
- 若当前平台没有结构化提问工具,则必须在对话中提出明确选项并停止流程,等待用户回复
|
|
21
|
+
- 存在 `AskUserQuestion` 时,使用它展示单选/多选选项;否则在对话中提出明确选项并等待用户回复
|
|
22
|
+
- 若无法使用 `AskUserQuestion`,则判定本会话结构化提问不可用;本会话后续决策点不得反复重试它,直接使用文本选项降级模式
|
|
24
23
|
- 不得用推荐规则、默认值、历史偏好或“用户应该会同意”的推断代替当前确认
|
|
25
24
|
- 用户明确选择前,不得写入对应状态字段、执行对应分支操作或自动继续下一阶段
|
|
26
25
|
|
|
@@ -31,7 +30,7 @@
|
|
|
31
30
|
- 单选决策点用 `AskUserQuestion` 的单选问题;多选决策点用多选问题
|
|
32
31
|
- 选项必须携带简短标签和影响说明;推荐项只能作为说明,不能自动选择
|
|
33
32
|
- 若工具调用成功,等待用户通过该问题作答;不得同时再输出一套文本选项
|
|
34
|
-
-
|
|
33
|
+
- 若工具不存在或工具调用失败,记录“本会话结构化提问不可用”,然后进入文本选项降级模式
|
|
35
34
|
|
|
36
35
|
## 最低呈现要求
|
|
37
36
|
|
|
@@ -1,12 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 稳定公开 CLI 协议
|
|
2
2
|
|
|
3
3
|
规范路径:`comet/reference/scripts.md`
|
|
4
4
|
|
|
5
|
-
本文件是 Comet
|
|
5
|
+
本文件是 Classic Skill 调用 Comet Runtime 的单一事实来源。Skill 只使用 PATH 中的公开 `comet` CLI;随包发布的 `comet/scripts/*.mjs` 属于内部安装与 Runtime 资产,不由 Skill 搜索或直接调用。
|
|
6
|
+
|
|
7
|
+
## CLI 引导
|
|
8
|
+
|
|
9
|
+
进入 workflow 时直接运行下方所需的公开 `comet` 命令。若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整;不得搜索 Skill 文件、枚举平台目录或直接调用内部 bundle。CLI 已启动但返回非零时,报告原错误,不得通过内部脚本重试。
|
|
6
10
|
|
|
7
11
|
## 公开工作流协议
|
|
8
12
|
|
|
9
|
-
|
|
13
|
+
日常工作流统一调用公开 CLI:
|
|
10
14
|
|
|
11
15
|
```bash
|
|
12
16
|
comet state select <change-name>
|
|
@@ -16,48 +20,14 @@ comet state check <change-name> <phase>
|
|
|
16
20
|
comet guard <change-name> <phase> --apply
|
|
17
21
|
comet handoff <change-name>
|
|
18
22
|
comet archive <change-name>
|
|
23
|
+
comet resume-probe . --stdin --json
|
|
24
|
+
comet classic intent route --stdin
|
|
19
25
|
```
|
|
20
26
|
|
|
21
27
|
当多个 active change 共存时,进入明确的 change 后先运行 `comet state select <change-name>`。普通源码写入只受该选择管辖;尚未选择时 hook 会阻塞并要求选择。单 active change 可继续自动归属。切换 branch/worktree 或选择失效后必须重新运行 `select`。
|
|
22
28
|
|
|
23
29
|
guard 的 `--apply` 在检查通过后推进状态。需要直接表达状态事件时使用 `comet state transition`;阶段推进后使用 `comet state next` 解析是否自动调用下一 Skill。
|
|
24
30
|
|
|
25
|
-
## 兼容、恢复与内部命令引导
|
|
26
|
-
|
|
27
|
-
以下脚本定位只用于旧版兼容、CLI 不可用时的恢复,以及 `/comet-classic` 内部入口命令。正常公开工作流不得优先采用此方式。Comet 脚本随 Skill 包分发在 `comet/scripts/` 下;需要恢复时不要硬编码路径,而应定位一次并缓存环境变量:
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
COMET_ENV="${COMET_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" "$HOME/.gemini" -path '*/comet/scripts/comet-env.mjs' -type f -print -quit 2>/dev/null)}"
|
|
31
|
-
if [ -z "$COMET_ENV" ]; then
|
|
32
|
-
echo "ERROR: comet-env.mjs not found. Ensure the comet skill is installed." >&2
|
|
33
|
-
return 1
|
|
34
|
-
fi
|
|
35
|
-
COMET_SCRIPTS_DIR="$(node "$COMET_ENV")"
|
|
36
|
-
COMET_STATE="$COMET_SCRIPTS_DIR/comet-state.mjs"
|
|
37
|
-
COMET_GUARD="$COMET_SCRIPTS_DIR/comet-guard.mjs"
|
|
38
|
-
COMET_HANDOFF="$COMET_SCRIPTS_DIR/comet-handoff.mjs"
|
|
39
|
-
COMET_ARCHIVE="$COMET_SCRIPTS_DIR/comet-archive.mjs"
|
|
40
|
-
COMET_INTENT="$COMET_SCRIPTS_DIR/comet-intent.mjs"
|
|
41
|
-
COMET_RESUME_PROBE="$COMET_SCRIPTS_DIR/comet-resume-probe.mjs"
|
|
42
|
-
|
|
43
|
-
# 脚本定位失败时停止流程
|
|
44
|
-
if [ -z "$COMET_SCRIPTS_DIR" ]; then
|
|
45
|
-
echo "ERROR: Comet scripts not found. Ensure the comet skill is installed." >&2
|
|
46
|
-
return 1
|
|
47
|
-
fi
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
只有进入上述兼容、恢复或内部命令路径时,Agent 才执行这些变量赋值。`COMET_INTENT` 和 `COMET_RESUME_PROBE` 仍是内部入口引导所需变量,不应全局移除。
|
|
51
|
-
|
|
52
|
-
| 变量 | 用途 |
|
|
53
|
-
|------|------|
|
|
54
|
-
| `COMET_STATE` | `.comet.yaml` 状态读写、phase 检查和恢复上下文 |
|
|
55
|
-
| `COMET_GUARD` | 阶段退出守卫和 `--apply` 状态推进 |
|
|
56
|
-
| `COMET_HANDOFF` | Design/Build handoff 上下文包生成 |
|
|
57
|
-
| `COMET_ARCHIVE` | 一键归档和主 spec 同步 |
|
|
58
|
-
| `COMET_INTENT` | `/comet-classic` 入口意图识别和路由评分 |
|
|
59
|
-
| `COMET_RESUME_PROBE` | 只读 Ambient Resume 探针,判断是否应恢复 active Comet workflow |
|
|
60
|
-
|
|
61
31
|
## 自动状态更新
|
|
62
32
|
|
|
63
33
|
guard 支持 `--apply` 参数,验证通过后自动更新 `.comet.yaml` 状态字段:
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
规范路径:`comet/reference/subagent-dispatch.md`
|
|
4
4
|
|
|
5
|
-
本文档提供在 Superpowers `subagent-driven-development` 技能**之上**应用的 Comet 专属扩展。Superpowers `subagent-driven-development` 技能提供基础连续派发循环(每个 task 派发全新 implementer,并包含默认 task reviewer 节点)并强制连续执行。本文档添加 Comet
|
|
5
|
+
本文档提供在 Superpowers `subagent-driven-development` 技能**之上**应用的 Comet 专属扩展。Superpowers `subagent-driven-development` 技能提供基础连续派发循环(每个 task 派发全新 implementer,并包含默认 task reviewer 节点)并强制连续执行。本文档添加 Comet 特有的子代理派发、任务追踪、状态验证、上下文恢复,以及审查/修复预算;Comet 的 `review_mode` 接管 reviewer 阶段,决定哪些任务需要 reviewer、需要几轮修复和最终审查。若 Superpowers 技能与本文档发生冲突时,以本文档中更具体的 Comet 约束为准。
|
|
6
6
|
|
|
7
7
|
> **⚠️ 关键约束 — 任务之间禁止暂停**
|
|
8
8
|
>
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
> - 存在无法从仓库、计划或既有上下文消除的真实歧义
|
|
14
14
|
> - 用户**明确**要求暂停
|
|
15
15
|
>
|
|
16
|
-
>
|
|
16
|
+
> 子代理派发操作失败属于运行停止条件,不自动构成新的用户决策点:将当前任务记录为 `BLOCKED` 并写明失败原因,停止派发循环,按当前 change 的阻塞与恢复流程处理;主会话不得接管实现。
|
|
17
17
|
>
|
|
18
18
|
> 此规则适用于整个派发循环,而非单个任务。
|
|
19
19
|
|
|
@@ -33,9 +33,9 @@
|
|
|
33
33
|
主会话**仅负责协调**,禁止直接执行 task。主会话禁止修改源代码。协调者唯一允许的文件修改是 plan、OpenSpec task 和 subagent 进度检查点的持久化更新。不得把多个 task 打包给同一个 agent。每个 task 派发一个全新的后台 implementer agent;当 `review_mode` 需要审查或修复时,task reviewer、修复 agent 和 final reviewer 也必须分别使用全新的后台 agent:
|
|
34
34
|
|
|
35
35
|
- **Claude Code**:对每个 implementer,以及 `review_mode` 要求的 task reviewer、修复 agent 和 final reviewer 使用 `Agent` 工具并设置 `run_in_background: true`。禁止内联执行 task,禁止错误进入需要预先创建 team 的团队模式。
|
|
36
|
-
-
|
|
36
|
+
- **其他平台**:使用 agent / Task / 多 agent 派发机制,并按其调度、上下文和结果返回方式执行。
|
|
37
37
|
- **禁止**跨 task 或角色复用 implementer、reviewer 或修复 agent。每个 agent 拥有全新的隔离上下文,并且只接收当前角色所需的单个 task 上下文。
|
|
38
|
-
-
|
|
38
|
+
- 若子代理派发操作失败,不得继续派发或由主会话代写实现;将当前任务记录为 `BLOCKED` 并写明失败原因,按当前 change 的阻塞与恢复流程处理。
|
|
39
39
|
|
|
40
40
|
### 1. 派发 Prompt 与回报契约
|
|
41
41
|
|
|
@@ -69,13 +69,12 @@ reviewer prompt 必须保持中立:
|
|
|
69
69
|
- 不得在 reviewer prompt 中预判、压低或禁止报告某个发现。若某个可能发现与 plan 冲突,让 reviewer 先报告,再询问用户以哪个要求为准。
|
|
70
70
|
- 不得把之前 task 的累计历史粘贴进后续派发。只提供当前 task、相关接口/约束,以及已加载的 Superpowers `subagent-driven-development` 技能暴露的交接产物。
|
|
71
71
|
|
|
72
|
-
**Model
|
|
72
|
+
**Model 选择**:存在 model 选择参数时,为不同角色选择合适的 model;否则直接使用默认 model。不得伪造 model 参数,也不得把缺少选择参数写成阻塞条件。可选择时,遵循 Superpowers `subagent-driven-development` 的 Model Selection 规则:
|
|
73
73
|
|
|
74
74
|
- **implementer / 修复 agent**:用 prose 描述的实现任务至少使用中档;多文件集成、需要模式匹配或调试 → 中档;需要设计判断或广泛理解代码库 → 高档。只有当 plan 文本已含完整待写代码(转写+测试),或只是单文件机械修复时,才用最便宜档。
|
|
75
75
|
- **reviewer(任务级/最终)**:按 diff 大小、复杂度和风险缩放。小机械 diff 不需要最高档;微妙并发改动才上高档。
|
|
76
76
|
- **final whole-branch review**:使用可用的最高档 model,不用会话默认档。
|
|
77
77
|
|
|
78
|
-
省略 model 等于让它跑会话最贵 model,直接违背本节目标。
|
|
79
78
|
|
|
80
79
|
### 2. Implementer 范围限制
|
|
81
80
|
|
|
@@ -97,6 +96,7 @@ implementer 或修复 agent 回报必须提供 **RED 失败命令与失败摘要
|
|
|
97
96
|
|
|
98
97
|
- 当前 plan task 唯一文本及映射的 OpenSpec task 文本
|
|
99
98
|
- 当前阶段:`implementing | task-review | checkoff | done | blocked | final-review | final-fix`
|
|
99
|
+
- 本次派发使用的 model(可以识别时)
|
|
100
100
|
- 实现提交哈希、变更文件和 RED/GREEN 证据
|
|
101
101
|
- 已选择的 `review_mode`
|
|
102
102
|
- 已通过的审查阶段及尚未解决的 reviewer 反馈
|
|
@@ -143,8 +143,8 @@ Comet 不读取、不写入、也不要求任何 Superpowers `subagent-driven-de
|
|
|
143
143
|
4. 运行定向验证:
|
|
144
144
|
|
|
145
145
|
```bash
|
|
146
|
-
comet state task-checkoff <plan-file> <plan-task-text>
|
|
147
|
-
comet state task-checkoff <classic-change-dir>/tasks.md <openspec-task-text>
|
|
146
|
+
comet state task-checkoff "<plan-file>" "<plan-task-text>"
|
|
147
|
+
comet state task-checkoff "<classic-change-dir>/tasks.md" "<openspec-task-text>"
|
|
148
148
|
```
|
|
149
149
|
|
|
150
150
|
仅在对应映射存在时运行第二条。脚本会要求任务文本恰好出现一次且该项已勾选;验证失败时不得进入下一个 task。
|
|
@@ -122,7 +122,7 @@ git commit -m "chore: archive <change-name>"
|
|
|
122
122
|
归档提交成功后,只执行 Step 1 中用户已经确认的远端交付方式:
|
|
123
123
|
|
|
124
124
|
- 「确认归档并立即推送」:推送当前绑定分支一次。
|
|
125
|
-
- 「确认归档、立即推送并创建 PR
|
|
125
|
+
- 「确认归档、立即推送并创建 PR」:先推送当前绑定分支一次,再通过已配置的 GitHub 集成创建 PR;Step 1 的明确选择就是创建 PR 的授权,不得再次改成其他分支处置方式。
|
|
126
126
|
|
|
127
127
|
push 失败时报告错误,保留 current selection 记录,不得清除选择或宣告完成;当前任务中只重试同一个 push。PR 创建失败时分支已经包含完整归档提交,报告错误并保留 current selection 记录;当前任务中只重试创建 PR。不得在失败后自动切换、删除、变基或改写分支。
|
|
128
128
|
|
|
@@ -63,7 +63,7 @@ git rev-parse HEAD
|
|
|
63
63
|
|
|
64
64
|
将计划写入文件后,返回文件路径。
|
|
65
65
|
|
|
66
|
-
**执行 subagent
|
|
66
|
+
**执行 subagent**:将上述任务派发给 subagent。
|
|
67
67
|
|
|
68
68
|
Subagent 完成后:
|
|
69
69
|
- 若返回有效文件路径且文件存在,记录为 plan
|
|
@@ -79,9 +79,9 @@ comet state set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
|
|
|
79
79
|
|
|
80
80
|
无需手动更新 phase,阶段守卫(guard `--apply`)会在退出条件满足后推进 `phase` 字段。
|
|
81
81
|
|
|
82
|
-
|
|
82
|
+
展示联合决策时,提供本工作流支持的全部工作区隔离和执行方式。不得预检、推断或筛除其他 Skill、分支、worktree、子代理派发或 model 选择能否使用。用户选择后直接执行对应动作;若动作实际失败,停止并报告原错误。某个字段只剩一个工作流合法值时说明原因并直接采用,不为单选项制造额外停顿。
|
|
83
83
|
|
|
84
|
-
|
|
84
|
+
计划写入后只提供**一个联合决策点**,一次收集:是否现在继续、工作区隔离、执行方式、TDD 模式和代码审查模式。选择 `branch` 时,分支名也必须在 Step 2 的同一个联合决策中确认或由用户覆盖。不得先询问“继续/暂停”,继续后又创建第二个配置或命名阻塞点。
|
|
85
85
|
|
|
86
86
|
| 选项 | 行为 | 说明 |
|
|
87
87
|
|------|------|------|
|
|
@@ -141,7 +141,7 @@ comet state set <name> build_pause null
|
|
|
141
141
|
- 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
|
|
142
142
|
- 来自 hotfix 路径 → 推荐 B
|
|
143
143
|
|
|
144
|
-
这些表格是 Step 2
|
|
144
|
+
这些表格是 Step 2 联合决策的一部分,不再单独暂停。始终展示本工作流支持的隔离和执行选项,不得因预判某个动作会失败而移除选项。在多个合法选项时,不得根据推荐规则自行选择 `current`、`branch` 或 `worktree`,也不得自行选择执行方式、TDD 模式或代码审查模式。推荐规则只能用于说明建议,不能替代用户确认。
|
|
145
145
|
|
|
146
146
|
用户选择后,更新 `isolation`、执行方式、TDD 模式和代码审查模式相关字段:
|
|
147
147
|
|
|
@@ -150,8 +150,7 @@ comet state set <name> isolation <current|branch|worktree>
|
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
- 若用户选择 `executing-plans`:运行 `comet state set <name> subagent_dispatch null`,再运行 `comet state set <name> build_mode executing-plans`
|
|
153
|
-
- 若用户选择 `subagent-driven-development
|
|
154
|
-
- 若无法确认真实后台调度能力,不得展示或写入 `build_mode: subagent-driven-development`。恢复状态若已记录该模式但能力不可用,回到 Step 2 的同一个联合决策并只展示可执行模式;不得另设“改选 executing-plans”停顿点
|
|
153
|
+
- 若用户选择 `subagent-driven-development`:先运行 `comet state set <name> subagent_dispatch confirmed` 记录已选择子代理执行,再运行 `comet state set <name> build_mode subagent-driven-development`
|
|
155
154
|
|
|
156
155
|
**TDD 模式**:
|
|
157
156
|
|
|
@@ -174,7 +173,7 @@ comet state set <name> isolation <current|branch|worktree>
|
|
|
174
173
|
|
|
175
174
|
`isolation` 是脚本级硬约束。full workflow 初始化时可以为 `null`,但只允许存在到本步骤之前。若保持 `null`,`build → verify` 的 guard 和 `comet state transition build-complete` 都会失败。full workflow 允许 `current`、`branch` 或 `worktree`,但 `current` 必须通过用户在 Step 2 显式选择后写入,不得静默默认。
|
|
176
175
|
|
|
177
|
-
`subagent_dispatch`
|
|
176
|
+
`subagent_dispatch` 是脚本级硬约束,用于记录用户已选择子代理执行。`build_mode: subagent-driven-development` 离开 build 阶段前必须同时满足 `subagent_dispatch: confirmed`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败;它不是能力检查。
|
|
178
177
|
|
|
179
178
|
`tdd_mode` 是脚本级硬约束。full workflow 离开 build 阶段前 `tdd_mode` 必须已选择为 `tdd` 或 `direct`,否则 `comet guard build --apply` 和 `comet state transition build-complete` 都会失败。
|
|
180
179
|
|
|
@@ -206,7 +205,7 @@ comet state set <name> build_mode direct
|
|
|
206
205
|
|
|
207
206
|
分支名由 Step 2 确认后,立即执行 `git checkout -b <branch-name>`,然后运行 `comet state set <name> isolation branch`,把新分支写入 `bound_branch`。后续工作在新分支上进行。
|
|
208
207
|
|
|
209
|
-
- **worktree
|
|
208
|
+
- **worktree**:**立即执行:** 使用 Skill 工具加载 Superpowers `using-git-worktrees` 技能创建隔离工作区。禁止用普通 shell 命令或原生工具绕过该技能;若加载时因不可用而失败,停止并报告该错误。
|
|
210
209
|
|
|
211
210
|
创建隔离后,确认计划文件可访问(分支方式天然可访问;worktree 方式需确认计划已提交)。若 worktree 模式下计划文件尚未提交,先提交计划文件再创建 worktree:
|
|
212
211
|
|
|
@@ -225,9 +224,9 @@ comet state select <change-name>
|
|
|
225
224
|
|
|
226
225
|
**执行计划**:必须按 `build_mode` 的真实运行位置处理。
|
|
227
226
|
|
|
228
|
-
- `build_mode: executing-plans`:**立即执行:** 使用 Skill 工具加载 Superpowers `executing-plans`
|
|
229
|
-
- `build_mode: subagent-driven-development`:主会话只负责协调,禁止直接编写实现代码。**立即执行:** 使用 Skill 工具加载 Superpowers `subagent-driven-development` 技能。技能加载后,读取 `comet/reference/subagent-dispatch.md` 获取 Comet
|
|
230
|
-
-
|
|
227
|
+
- `build_mode: executing-plans`:**立即执行:** 使用 Skill 工具加载 Superpowers `executing-plans` 技能。禁止跳过此步骤。若加载失败,停止并报告错误,不要用普通对话替代该步骤。技能加载后,ARGUMENTS 必须包含与 Step 1 相同的 Language 约束:`Language: 使用 comet state get <name> language 读取到的 Comet 配置产物语言输出`。按计划执行。
|
|
228
|
+
- `build_mode: subagent-driven-development`:主会话只负责协调,禁止直接编写实现代码。**立即执行:** 使用 Skill 工具加载 Superpowers `subagent-driven-development` 技能。技能加载后,读取 `comet/reference/subagent-dispatch.md` 获取 Comet 专属扩展(子代理派发、任务隔离、勾选验证、TDD 约束、连续执行、上下文恢复),与技能工作流配合应用。若两者发生冲突,以更具体的 Comet 扩展为准。
|
|
229
|
+
- 若子代理派发操作失败,按 `comet/reference/subagent-dispatch.md` 将当前任务记录为 `BLOCKED` 并带上失败原因;主会话不得接管实现。
|
|
231
230
|
|
|
232
231
|
**TDD 模式执行约束**:
|
|
233
232
|
|
|
@@ -247,7 +246,7 @@ comet state select <change-name>
|
|
|
247
246
|
|
|
248
247
|
要求(适用于 `standard` 和 `thorough`):
|
|
249
248
|
- `requesting-code-review` 技能必须在 `comet guard <change-name> build --apply` 之前加载
|
|
250
|
-
-
|
|
249
|
+
- 若当前为 `standard` 或 `thorough` 且加载 `requesting-code-review` 失败,必须停止并请用户选择:解决错误后重试,或明确切换为 `review_mode: off` 并记录原因。用户未明确切换前不得跳过 review gate 或继续 guard
|
|
251
250
|
- CRITICAL review 发现(安全漏洞、数据丢失风险、构建/测试失败)必须先修复,不得带入 verify
|
|
252
251
|
- 非 CRITICAL review 发现如选择接受,必须在 tasks.md、commit body、验证报告草稿或其他持久产物中记录接受原因和影响范围
|
|
253
252
|
|
|
@@ -264,8 +263,8 @@ comet state select <change-name>
|
|
|
264
263
|
| 规模 | 触发条件 | 做法 |
|
|
265
264
|
|------|---------|------|
|
|
266
265
|
| 小 | 遗漏验收场景、边界条件 | 直接编辑 delta spec + design.md,追加 tasks.md 任务 |
|
|
267
|
-
| 中 | 接口变更、新增组件、数据流变化 |
|
|
268
|
-
| 大 | 全新 capability 需求 |
|
|
266
|
+
| 中 | 接口变更、新增组件、数据流变化 | **暂停、展示选择并等待用户明确确认后**,必须使用 Skill 工具加载 Superpowers `brainstorming` 更新 Design Doc + delta spec |
|
|
267
|
+
| 大 | 全新 capability 需求 | **暂停、展示拆分选择并等待用户明确确认**;用户确认后,通过 `/comet-open` 创建独立 change |
|
|
269
268
|
|
|
270
269
|
**50% 阈值判定**:以 tasks.md 初始任务总数为基准,若新增任务数超过该总数的一半,视为超出原计划范围,**必须按 `comet/reference/decision-point.md` 的协议暂停并等待用户决定是否拆分为新 change**。
|
|
271
270
|
|
|
@@ -30,10 +30,10 @@ agent 做决策只需读本节,参考附录按需查阅。
|
|
|
30
30
|
|
|
31
31
|
**Step 0: 活跃 Change 发现与意图判定**
|
|
32
32
|
|
|
33
|
-
1. 先按 `comet/reference/scripts.md`
|
|
33
|
+
1. 先按 `comet/reference/scripts.md` 直接运行公开 Comet CLI 命令。
|
|
34
34
|
2. 运行 `comet classic openspec -- list --json` 获取所有活跃 change。
|
|
35
35
|
3. 根据用户请求、active change 列表和必要仓库状态填写 `CometIntentFrame`。
|
|
36
|
-
4. 优先用 `
|
|
36
|
+
4. 优先用 `comet classic intent route --stdin` 传入 frame JSON,获取 runtime 规范化路由。`CometIntentFrame + runtime scorer` 是事实源;本节自然语言规则只用于意图识别槽位提取。
|
|
37
37
|
5. 按 runtime route 处理:
|
|
38
38
|
- `hotfix` → 直接调用 `/comet-hotfix`
|
|
39
39
|
- `tweak` → 直接调用 `/comet-tweak`
|
|
@@ -55,7 +55,7 @@ comet state select <change-name>
|
|
|
55
55
|
当用户未显式输入 `/comet-classic`,但当前仓库可能已有 active Comet change 时,开始处理需要改动或调查的任务前先运行只读探针:
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
|
-
|
|
58
|
+
comet resume-probe . --stdin --json
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
探针只读仓库状态,不修改文件。按返回值处理:
|
|
@@ -184,7 +184,7 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
|
|
|
184
184
|
|
|
185
185
|
流转链:open → design → build → verify → archive
|
|
186
186
|
|
|
187
|
-
**连续执行要求**:从检测到的阶段开始,agent
|
|
187
|
+
**连续执行要求**:从检测到的阶段开始,agent 自动推进后续阶段。但**自动推进仅适用于没有用户决策的衔接点**。遇到用户决策点时,必须提出明确选项并暂停等待用户回复,不得用推荐规则、默认值或历史偏好代替用户确认,也不得仅输出文字提示后继续执行。
|
|
188
188
|
|
|
189
189
|
**阶段推进与自动衔接的区分**:每个子 skill 退出前都会运行阶段守卫 `--apply` 推进 `.comet.yaml` 的 `phase` 字段——这一步**始终发生**,与 `auto_transition` 无关。之后子 skill 运行 `comet state next <name>` 解析下一步:`auto_transition` 不为 `false` 时输出 `NEXT: auto`(自动调用下一 skill),为 `false` 时输出 `NEXT: manual`(不调用下一 skill,按 `HINT` 交还控制权)。`NEXT: manual` 不是用户决策点,不得再询问“是否继续”。因此 `auto_transition` **只控制是否自动调用下一个 skill,不影响 phase 推进**。无论 `auto_transition` 取何值,下方真正的用户决策点都必须阻塞等待。
|
|
190
190
|
|
|
@@ -194,7 +194,7 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
|
|
|
194
194
|
1. workflow 目标选择:多个 active changes、继续现有 change/创建新 change、或批量拆分完成后选择先启动哪一个
|
|
195
195
|
2. open 阶段 proposal/design/tasks 最终审视确认(同时确认 change 名称与范围;清晰请求不做前置摘要/命名确认)
|
|
196
196
|
3. brainstorming 确认设计方案
|
|
197
|
-
4. build 阶段一次性联合选择 plan-ready
|
|
197
|
+
4. build 阶段一次性联合选择 plan-ready 暂停或完整工作方式(工作区隔离 + 执行方式 + TDD 模式 + 代码审查模式;选择 branch 时同时确认分支名)
|
|
198
198
|
5. verify 阶段接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移,或第 4 次失败后选择继续修复/停止;前 3 次明确可修复失败自动闭环
|
|
199
199
|
6. archive 阶段执行归档脚本前的最终确认
|
|
200
200
|
7. 归档改动精确提交后选择 finishing-branch 分支处理方式
|
|
@@ -202,7 +202,7 @@ hotfix/tweak 的范围判定采用三层分工,避免「用纯文件数当硬
|
|
|
202
202
|
9. build 阶段范围扩张需重新设计或拆分新 change
|
|
203
203
|
10. open 阶段大型 PRD 是否拆分为多个 changes
|
|
204
204
|
|
|
205
|
-
agent
|
|
205
|
+
agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须自动继续推进,不得中途退出。到达决策点时,**禁止跳过用户确认或自动选择——必须提出明确选项并获取用户选择后才能继续**。
|
|
206
206
|
|
|
207
207
|
**红旗清单** — 以下想法出现时立即停止并检查:
|
|
208
208
|
|
|
@@ -269,7 +269,7 @@ agent 不应跳过这些决策点;其他明确无歧义的阶段衔接必须
|
|
|
269
269
|
|
|
270
270
|
### 脚本定位
|
|
271
271
|
|
|
272
|
-
|
|
272
|
+
每个会话按 `comet/reference/scripts.md` 直接运行公开 CLI 命令。关键入口:
|
|
273
273
|
|
|
274
274
|
```bash
|
|
275
275
|
comet guard <change-name> <phase> --apply # 阶段守卫 + 自动状态更新
|
|
@@ -18,7 +18,7 @@ description: "仅在用户明确调用 /comet-design,或由 Comet 根 Skill/ru
|
|
|
18
18
|
|
|
19
19
|
### 0. 入口状态验证(Entry Check)
|
|
20
20
|
|
|
21
|
-
按 `comet/reference/scripts.md`
|
|
21
|
+
按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令,然后执行入口验证;从任意入口恢复时先按 `comet/reference/context-recovery.md` 运行恢复检查:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
24
|
comet state select <change-name>
|
|
@@ -149,7 +149,7 @@ brainstorming 产出设计方案后,**必须按 `comet/reference/decision-poin
|
|
|
149
149
|
|
|
150
150
|
用户确认设计方案后,在创建 Design Doc 前,创建或更新已增量维护的检查点文件,将其定稿为确认后的设计方案摘要:
|
|
151
151
|
|
|
152
|
-
|
|
152
|
+
使用文件工具确保 `<classic-change-dir>/.comet/handoff/` 存在;不要依赖 POSIX 专用目录命令。
|
|
153
153
|
|
|
154
154
|
`<classic-change-dir>/.comet/handoff/brainstorm-summary.md` 结构:
|
|
155
155
|
|
|
@@ -225,9 +225,9 @@ comet guard <change-name> design --apply
|
|
|
225
225
|
|
|
226
226
|
只在 **Design Doc 和状态证据落盘后**、进入 Build 前考虑主动式压缩。先确认 `design_doc`、最新 handoff、`handoff_hash` 和 design guard 均已成功持久化;这样压缩后可从文件恢复,不会丢失尚未写入的设计判断。
|
|
227
227
|
|
|
228
|
-
-
|
|
229
|
-
-
|
|
230
|
-
- 不得用 shell
|
|
228
|
+
- 上下文窗口确有压力且存在可调用的原生压缩机制时,可以触发一次,并在恢复提示中列出 change、下一步和需重新加载的 Design Doc/handoff 文件
|
|
229
|
+
- 压缩只能由用户手动触发时,给出一次非阻塞建议并继续;**不得阻塞**、不得额外制造确认点
|
|
230
|
+
- 不得用 shell 命令或摘要伪造上下文压缩
|
|
231
231
|
|
|
232
232
|
## 退出条件
|
|
233
233
|
|
|
@@ -26,7 +26,7 @@ description: "仅在用户明确调用 /comet-hotfix,或由 Comet 根 Skill/ru
|
|
|
26
26
|
|
|
27
27
|
执行链路:open → build → verify → archive。Hotfix 为每个阶段提供默认决策:精简开启、直接构建、按规模验证、验证通过后进入归档前最终确认。
|
|
28
28
|
|
|
29
|
-
开始前按 `comet/reference/scripts.md`
|
|
29
|
+
开始前按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet/reference/context-recovery.md` 检查 phase/workflow。
|
|
30
30
|
|
|
31
31
|
恢复已有 hotfix change 时,第一项状态操作必须是 `comet state select <change-name>`;创建新 change 时,在 `.comet.yaml` 初始化成功后立即运行该命令,再进入源码写入步骤。
|
|
32
32
|
|
|
@@ -157,7 +157,7 @@ comet guard <change-name> build --apply
|
|
|
157
157
|
<IMPORTANT>
|
|
158
158
|
Hotfix 流程默认 **一次性连续执行**。调用 `/comet-hotfix` 后,agent 在 hotfix 自有步骤间自动推进,不主动停顿。**例外**:若 `auto_transition: false`,则在每个 phase 边界(build/verify/archive 之间)结束当前调用并按 `HINT` 交还控制权,由用户稍后手动运行下一阶段命令;这是手动衔接,不是新的确认点。无论 `auto_transition` 取何值,以下真正的用户决策仍需暂停:
|
|
159
159
|
|
|
160
|
-
1.
|
|
160
|
+
1. 遇到升级判定信号(见「升级判定」章节),**必须暂停、展示选择并等待用户明确选择**:继续 hotfix 流程,还是升级为完整 `/comet-classic` 流程
|
|
161
161
|
2. 验证阶段(comet-verify)接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移或超过自动修复上限后的策略决策;前 3 次明确可修复失败自动闭环
|
|
162
162
|
3. 归档前最终确认,以及归档提交后的分支处理决策
|
|
163
163
|
|
|
@@ -19,10 +19,25 @@ Native 保存需求、完整目标规格、状态和证据。你负责理解、
|
|
|
19
19
|
|
|
20
20
|
Native 主流程不依赖任何外部 Skill。
|
|
21
21
|
|
|
22
|
+
## CLI 引导
|
|
23
|
+
|
|
24
|
+
Native Skill 只使用 PATH 中的公开 `comet native <cmd>` CLI;随 Skill 发布的命令 bundle 属于内部安装与 Runtime 资产,不由 Skill 搜索或直接调用。若命令返回 `command not found`、`executable not found` 或 `ENOENT`,停止并说明 Comet CLI 安装不完整;不得搜索 Skill 文件、枚举平台目录或直接调用内部 bundle。
|
|
25
|
+
|
|
26
|
+
常用命令:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
comet native status [--json]
|
|
30
|
+
comet native show <change-name>
|
|
31
|
+
comet native select <change-name>
|
|
32
|
+
comet native new <change-name> [--language en|zh-CN]
|
|
33
|
+
comet native next <change-name> --summary <text> [--confirmed]
|
|
34
|
+
comet native archive <change-name> --dry-run
|
|
35
|
+
```
|
|
36
|
+
|
|
22
37
|
## 开始或恢复
|
|
23
38
|
|
|
24
39
|
1. 运行 `comet native status`,确认当前 change 和 phase。
|
|
25
|
-
2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build
|
|
40
|
+
2. 对目标运行 `comet native show <change-name>`;Verify、Archive 或失败后的 Build 再对 status 命令加 `--details` 运行。
|
|
26
41
|
3. 需要更多 acceptance 时,按 `acceptancePage.nextCursor` 分页;findings 被截断时,先处理已返回项,再重新读取。
|
|
27
42
|
4. 确认目标后运行 `comet native select <change-name>`。
|
|
28
43
|
|
|
@@ -79,7 +94,7 @@ comet native next <change-name> \
|
|
|
79
94
|
|
|
80
95
|
进入 Build 后按以下循环收敛:
|
|
81
96
|
|
|
82
|
-
1. 运行 `status <change-name> --details
|
|
97
|
+
1. 运行 `comet native status <change-name> --details`,读取当前需要的 acceptance 页;上一轮 Verify 失败时,优先处理 failed/missing acceptance 和 failed check。
|
|
83
98
|
2. 完成一批相关的实际修复。需要中断时可以写 checkpoint,但 checkpoint 不是完成证据。
|
|
84
99
|
3. 形成候选实现后,重新读取 brief、完整规格和全部 acceptance,执行一次完整审查。
|
|
85
100
|
4. 运行真实验证并提交 Verify 结果。
|
|
@@ -120,6 +120,18 @@ comet native receipt manual <change-name> \
|
|
|
120
120
|
|
|
121
121
|
只为真实执行的命令或人工观察生成 receipt。失败、跳过、阻塞或超时结果不能作为 pass。
|
|
122
122
|
|
|
123
|
+
批量刷新过期 receipt:
|
|
124
|
+
|
|
125
|
+
```text
|
|
126
|
+
comet native receipt refresh <change-name> [--apply]
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
receipt 绑定生成时的 revision、contract、scope、snapshot 与 artifact。任何一次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,导致此前签发的 receipt 绑定过期。`next --result` 会因此报 `verification-receipt-binding-mismatch` 并列出每个过期 receipt 及其不一致字段。
|
|
130
|
+
|
|
131
|
+
不带 `--apply`(默认)为预览:只报告哪些 manual receipt 过期、哪些 automated receipt 需重跑、哪些 required-check receipt 需用 `comet native check` 重生成,不改动任何文件。
|
|
132
|
+
|
|
133
|
+
带 `--apply` 时:只对绑定不一致仅限于 `sourceRevision` 的过期 manual receipt 按当前 revision 重新签发,并把规范证据块写回 verification.md 的 `# Acceptance evidence` 段;contract、scope、snapshot 或 artifact 不一致仍会阻塞并要求重新人工验证。automated receipt 不会被静默重签(它证明一次真实命令执行),refresh 只报告需重跑的命令让你用 `receipt automated` 重新执行。
|
|
134
|
+
|
|
123
135
|
## 阶段推进
|
|
124
136
|
|
|
125
137
|
```text
|
|
@@ -39,6 +39,8 @@ comet native doctor <change-name> --repair --strategy continue
|
|
|
39
39
|
|
|
40
40
|
brief、规格、实现、报告或 receipt 改变后,旧 scope 或 Verify pass 可能失效。按 continuation 回到 Build,重新确认发生变化的用户行为、生成新 scope 并重新验证。不要复用旧 pass 或旧 preflight。
|
|
41
41
|
|
|
42
|
+
receipt 与 revision 绑定:每次状态写入(checkpoint、规格刷新、阶段推进)都会让 revision 递增,此前签发的 receipt 会因此绑定过期。`next --result` 报 `verification-receipt-binding-mismatch` 时,finding 会列出每个过期 receipt 及其不一致字段(如 `sourceRevision: expected 6, got 5`),并给出恢复命令。只有 manual evidence 仅发生 sourceRevision 不一致时,才可以不回到 Verify,运行 `comet native receipt refresh <change> --apply` 按当前 revision 重签并写回 verification.md;contract、scope、snapshot 或 artifact 不一致都必须重新验证。automated receipt 必须用 `receipt automated` 重新执行原命令,不能静默重签。
|
|
43
|
+
|
|
42
44
|
## Verify fail 与 repair stop
|
|
43
45
|
|
|
44
46
|
Verify fail 回到 Build 后:
|
|
@@ -29,7 +29,7 @@ Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程
|
|
|
29
29
|
|
|
30
30
|
执行链路:open → OpenSpec apply → verify → archive。Tweak 为每个阶段提供默认决策:精简开启、通过 OpenSpec apply 直接构建、按规模与 delta spec 判定验证轻重、验证通过后进入归档前最终确认。
|
|
31
31
|
|
|
32
|
-
开始前按 `comet/reference/scripts.md`
|
|
32
|
+
开始前按 `comet/reference/scripts.md` 运行公开 Comet CLI 命令;从任意入口恢复时先按 `comet/reference/context-recovery.md` 检查 phase/workflow。
|
|
33
33
|
|
|
34
34
|
恢复已有 tweak change 时,第一项状态操作必须是 `comet state select <change-name>`;创建新 change 时,在 `.comet.yaml` 初始化成功后立即运行该命令,再进入源码写入步骤。
|
|
35
35
|
|
|
@@ -153,7 +153,7 @@ comet state set <change-name> verify_mode full
|
|
|
153
153
|
<IMPORTANT>
|
|
154
154
|
Tweak 流程默认 **一次性连续执行**。调用 `/comet-tweak` 后,agent 在 tweak 自有步骤间自动推进,不主动停顿。**例外**:若 `auto_transition: false`,则在每个 phase 边界(build/verify/archive 之间)结束当前调用并按 `HINT` 交还控制权,由用户稍后手动运行下一阶段命令;这是手动衔接,不是新的确认点。无论 `auto_transition` 取何值,以下真正的用户决策仍需暂停:
|
|
155
155
|
|
|
156
|
-
1.
|
|
156
|
+
1. 遇到升级判定信号(见「升级判定」章节),**必须暂停、展示选择并等待用户明确选择**:继续 tweak 轻量流程,还是升级为完整 `/comet-classic` 流程
|
|
157
157
|
2. 验证阶段(comet-verify)接受 WARNING/SUGGESTION 偏差、处理 Spec 漂移或超过自动修复上限后的策略决策;前 3 次明确可修复失败自动闭环
|
|
158
158
|
3. 归档前最终确认,以及归档提交后的分支处理决策
|
|
159
159
|
|