cc-devflow 4.2.0 → 4.4.1

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.
Files changed (559) hide show
  1. package/.claude/skills/cc-act/CHANGELOG.md +64 -0
  2. package/.claude/skills/cc-act/PLAYBOOK.md +212 -0
  3. package/.claude/skills/cc-act/SKILL.md +322 -0
  4. package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +64 -0
  5. package/.claude/skills/cc-act/assets/RELEASE_NOTE_TEMPLATE.md +25 -0
  6. package/.claude/skills/cc-act/references/closure-contract.md +49 -0
  7. package/.claude/skills/cc-act/references/git-commit-guidelines.md +83 -0
  8. package/.claude/skills/cc-act/scripts/archive-requirement.sh +49 -0
  9. package/.claude/skills/cc-act/scripts/cc-act-common.sh +240 -0
  10. package/.claude/skills/cc-act/scripts/detect-ship-target.sh +82 -0
  11. package/.claude/skills/cc-act/scripts/generate-status-report.sh +83 -0
  12. package/.claude/skills/cc-act/scripts/render-pr-brief.sh +195 -0
  13. package/.claude/skills/cc-act/scripts/sync-act-docs.sh +315 -0
  14. package/.claude/skills/cc-act/scripts/verify-act-gate.sh +63 -0
  15. package/.claude/skills/cc-check/CHANGELOG.md +73 -0
  16. package/.claude/skills/cc-check/PLAYBOOK.md +153 -0
  17. package/.claude/skills/cc-check/SKILL.md +345 -0
  18. package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +50 -0
  19. package/.claude/skills/cc-check/references/gate-contract.md +29 -0
  20. package/.claude/skills/cc-check/references/review-contract.md +45 -0
  21. package/.claude/skills/cc-check/scripts/render-report-card.js +229 -0
  22. package/.claude/skills/cc-check/scripts/run-quality-gates.sh +86 -0
  23. package/.claude/skills/cc-check/scripts/verify-gate.sh +57 -0
  24. package/.claude/skills/cc-do/CHANGELOG.md +49 -0
  25. package/.claude/skills/cc-do/PLAYBOOK.md +119 -0
  26. package/.claude/skills/cc-do/SKILL.md +216 -0
  27. package/.claude/skills/cc-do/references/execution-recovery.md +86 -0
  28. package/.claude/skills/cc-do/references/parallel-dispatch.md +80 -0
  29. package/.claude/skills/cc-do/scripts/build-task-context.sh +184 -0
  30. package/.claude/skills/cc-do/scripts/cc-do-common.sh +79 -0
  31. package/.claude/skills/cc-do/scripts/check-task-status.sh +92 -0
  32. package/.claude/skills/cc-do/scripts/detect-file-conflicts.sh +87 -0
  33. package/.claude/skills/cc-do/scripts/mark-task-complete.sh +119 -0
  34. package/.claude/skills/cc-do/scripts/record-review-decision.sh +89 -0
  35. package/.claude/skills/cc-do/scripts/recover-workflow.sh +84 -0
  36. package/.claude/skills/cc-do/scripts/run-problem-analysis.sh +70 -0
  37. package/.claude/skills/cc-do/scripts/select-ready-tasks.sh +135 -0
  38. package/.claude/skills/cc-do/scripts/verify-task-gates.sh +94 -0
  39. package/.claude/skills/cc-do/scripts/write-task-checkpoint.sh +102 -0
  40. package/.claude/skills/cc-investigate/CHANGELOG.md +26 -0
  41. package/.claude/skills/cc-investigate/PLAYBOOK.md +49 -0
  42. package/.claude/skills/cc-investigate/SKILL.md +221 -0
  43. package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +55 -0
  44. package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +52 -0
  45. package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +103 -0
  46. package/.claude/skills/cc-investigate/references/investigation-contract.md +28 -0
  47. package/.claude/skills/cc-investigate/scripts/bootstrap-analysis.sh +38 -0
  48. package/.claude/skills/cc-plan/CHANGELOG.md +99 -0
  49. package/.claude/skills/cc-plan/PLAYBOOK.md +106 -0
  50. package/.claude/skills/cc-plan/SKILL.md +325 -0
  51. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +155 -0
  52. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +98 -0
  53. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +108 -0
  54. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +79 -0
  55. package/.claude/skills/cc-plan/references/planning-contract.md +82 -0
  56. package/.claude/skills/cc-plan/scripts/bump-skill-version.sh +103 -0
  57. package/.claude/skills/cc-plan/scripts/parse-task-dependencies.js +75 -0
  58. package/.claude/skills/cc-plan/scripts/validate-scope.sh +78 -0
  59. package/.claude/skills/cc-roadmap/CHANGELOG.md +114 -0
  60. package/.claude/skills/cc-roadmap/PLAYBOOK.md +136 -0
  61. package/.claude/skills/cc-roadmap/SKILL.md +259 -0
  62. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +45 -0
  63. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +153 -0
  64. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +48 -0
  65. package/.claude/skills/cc-roadmap/references/roadmap-dialogue.md +37 -0
  66. package/.claude/skills/cc-roadmap/scripts/bump-skill-version.sh +103 -0
  67. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/markdown.js +604 -0
  68. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/query.js +63 -0
  69. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/schema.js +245 -0
  70. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/store.js +139 -0
  71. package/.claude/skills/cc-roadmap/scripts/locate-roadmap-item.sh +109 -0
  72. package/.claude/skills/cc-roadmap/scripts/roadmap-tracking.js +153 -0
  73. package/.claude/skills/cc-roadmap/scripts/sync-roadmap-progress.sh +100 -0
  74. package/.claude/skills/cc-simplify/CHANGELOG.md +10 -0
  75. package/.claude/skills/cc-simplify/SKILL.md +55 -0
  76. package/.claude/skills/cc-spec-init/CHANGELOG.md +7 -0
  77. package/.claude/skills/cc-spec-init/PLAYBOOK.md +55 -0
  78. package/.claude/skills/cc-spec-init/SKILL.md +127 -0
  79. package/.claude/skills/cc-spec-init/assets/CAPABILITY_TEMPLATE.md +63 -0
  80. package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json +25 -0
  81. package/.claude/skills/cc-spec-init/assets/INDEX_TEMPLATE.md +34 -0
  82. package/.claude/skills/cc-spec-init/references/spec-contract.md +22 -0
  83. package/.claude/skills/cc-spec-init/scripts/bootstrap-specs.sh +31 -0
  84. package/.claude/skills/cc-spec-init/scripts/validate-spec-links.sh +45 -0
  85. package/CHANGELOG.md +101 -4
  86. package/README.md +120 -755
  87. package/README.zh-CN.md +119 -755
  88. package/bin/adapt.js +2 -6
  89. package/bin/cc-devflow-cli.js +72 -177
  90. package/config/distributable-skills.json +24 -0
  91. package/docs/CLAUDE.md +10 -6
  92. package/docs/commands/README.md +19 -46
  93. package/docs/commands/README.zh-CN.md +25 -48
  94. package/docs/examples/BY-ARTIFACT.md +7 -0
  95. package/docs/examples/README.md +38 -0
  96. package/docs/examples/START-HERE.md +149 -0
  97. package/docs/examples/example-bindings.json +38 -0
  98. package/docs/examples/full-design-blocked/BACKLOG.md +45 -0
  99. package/docs/examples/full-design-blocked/README.md +55 -0
  100. package/docs/examples/full-design-blocked/ROADMAP.md +53 -0
  101. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +154 -0
  102. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json +146 -0
  103. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +78 -0
  104. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +52 -0
  105. package/docs/examples/full-design-blocked/roadmap-tracking.json +50 -0
  106. package/docs/examples/local-handoff/BACKLOG.md +45 -0
  107. package/docs/examples/local-handoff/README.md +56 -0
  108. package/docs/examples/local-handoff/ROADMAP.md +45 -0
  109. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md +39 -0
  110. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md +29 -0
  111. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +71 -0
  112. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json +98 -0
  113. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +59 -0
  114. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +44 -0
  115. package/docs/examples/local-handoff/roadmap-tracking.json +48 -0
  116. package/docs/examples/pdca-loop/BACKLOG.md +46 -0
  117. package/docs/examples/pdca-loop/README.md +58 -0
  118. package/docs/examples/pdca-loop/ROADMAP.md +133 -0
  119. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +72 -0
  120. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md +29 -0
  121. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +72 -0
  122. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +201 -0
  123. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +73 -0
  124. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +44 -0
  125. package/docs/examples/pdca-loop/roadmap-tracking.json +114 -0
  126. package/docs/examples/scripts/check-example-bindings.sh +116 -0
  127. package/docs/guides/getting-started.md +94 -129
  128. package/docs/guides/getting-started.zh-CN.md +103 -84
  129. package/docs/skill-runtime-migration.md +46 -0
  130. package/docs/v4.3.0-migration-guide.md +111 -0
  131. package/lib/compiler/CLAUDE.md +55 -84
  132. package/lib/compiler/__tests__/drift.test.js +1 -1
  133. package/lib/compiler/__tests__/errors.test.js +0 -1
  134. package/lib/compiler/__tests__/integration.test.js +49 -3
  135. package/lib/compiler/__tests__/manifest.test.js +0 -156
  136. package/lib/compiler/__tests__/parser.test.js +33 -104
  137. package/lib/compiler/__tests__/schemas.test.js +30 -34
  138. package/lib/compiler/__tests__/skills-registry.test.js +114 -0
  139. package/lib/compiler/__tests__/transformer.test.js +5 -9
  140. package/lib/compiler/emitters/antigravity-emitter.js +5 -213
  141. package/lib/compiler/emitters/base-emitter.js +3 -298
  142. package/lib/compiler/emitters/codex-emitter.js +4 -202
  143. package/lib/compiler/emitters/cursor-emitter.js +3 -287
  144. package/lib/compiler/emitters/qwen-emitter.js +4 -176
  145. package/lib/compiler/index.js +65 -345
  146. package/lib/compiler/manifest.js +6 -68
  147. package/lib/compiler/parser.js +31 -63
  148. package/lib/compiler/platforms.js +32 -277
  149. package/lib/compiler/resource-copier.js +176 -6
  150. package/lib/compiler/rules-emitters/__tests__/antigravity-rules-emitter.test.js +3 -3
  151. package/lib/compiler/rules-emitters/__tests__/cursor-rules-emitter.test.js +14 -4
  152. package/lib/compiler/rules-emitters/__tests__/qwen-rules-emitter.test.js +16 -7
  153. package/lib/compiler/rules-emitters/antigravity-rules-emitter.js +10 -15
  154. package/lib/compiler/rules-emitters/base-rules-emitter.js +5 -5
  155. package/lib/compiler/rules-emitters/cursor-rules-emitter.js +7 -12
  156. package/lib/compiler/rules-emitters/index.js +6 -3
  157. package/lib/compiler/rules-emitters/qwen-rules-emitter.js +7 -7
  158. package/lib/compiler/schemas.js +8 -4
  159. package/lib/compiler/skills-registry.js +213 -15
  160. package/lib/compiler/transformer.js +1 -1
  161. package/lib/skill-runtime/CLAUDE.md +19 -0
  162. package/lib/skill-runtime/__tests__/autopilot.test.js +210 -0
  163. package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js +181 -0
  164. package/lib/skill-runtime/__tests__/delegation.test.js +97 -0
  165. package/lib/skill-runtime/__tests__/dispatch.test.js +267 -0
  166. package/lib/skill-runtime/__tests__/intent.test.js +219 -0
  167. package/lib/skill-runtime/__tests__/lifecycle.test.js +169 -0
  168. package/lib/skill-runtime/__tests__/paths.test.js +42 -0
  169. package/lib/skill-runtime/__tests__/planner.tdd.test.js +250 -0
  170. package/lib/skill-runtime/__tests__/prepare-pr.test.js +139 -0
  171. package/lib/skill-runtime/__tests__/query.test.js +284 -0
  172. package/lib/skill-runtime/__tests__/runtime.integration.test.js +279 -0
  173. package/lib/skill-runtime/__tests__/schemas.test.js +207 -0
  174. package/lib/skill-runtime/__tests__/team-state.test.js +51 -0
  175. package/lib/skill-runtime/__tests__/worker-run.test.js +253 -0
  176. package/lib/skill-runtime/__tests__/worker.test.js +56 -0
  177. package/lib/skill-runtime/artifacts.js +93 -0
  178. package/lib/skill-runtime/delegation.js +533 -0
  179. package/lib/skill-runtime/index.js +34 -0
  180. package/lib/skill-runtime/intent.js +333 -0
  181. package/lib/skill-runtime/lifecycle.js +294 -0
  182. package/lib/skill-runtime/operations/CLAUDE.md +19 -0
  183. package/lib/skill-runtime/operations/approve.js +66 -0
  184. package/lib/skill-runtime/operations/autopilot-core.js +337 -0
  185. package/lib/skill-runtime/operations/autopilot-execution.js +307 -0
  186. package/lib/skill-runtime/operations/autopilot-shared.js +48 -0
  187. package/lib/skill-runtime/operations/autopilot.js +163 -0
  188. package/lib/skill-runtime/operations/dispatch.js +454 -0
  189. package/lib/skill-runtime/operations/init.js +64 -0
  190. package/lib/{harness → skill-runtime}/operations/janitor.js +9 -6
  191. package/lib/skill-runtime/operations/plan.js +59 -0
  192. package/lib/skill-runtime/operations/prepare-pr.js +25 -0
  193. package/lib/{harness → skill-runtime}/operations/release.js +18 -5
  194. package/lib/skill-runtime/operations/resume.js +143 -0
  195. package/lib/skill-runtime/operations/snapshot.js +45 -0
  196. package/lib/skill-runtime/operations/verify.js +170 -0
  197. package/lib/skill-runtime/operations/worker-run.js +529 -0
  198. package/lib/skill-runtime/operations/worker.js +33 -0
  199. package/lib/skill-runtime/paths.js +213 -0
  200. package/lib/skill-runtime/planner.js +519 -0
  201. package/lib/skill-runtime/query.js +157 -0
  202. package/lib/skill-runtime/review.js +557 -0
  203. package/lib/skill-runtime/schemas.js +400 -0
  204. package/lib/{harness → skill-runtime}/store.js +45 -30
  205. package/lib/skill-runtime/team-state.js +122 -0
  206. package/package.json +13 -11
  207. package/.claude/CLAUDE.md +0 -125
  208. package/.claude/agents/architecture-designer.md +0 -443
  209. package/.claude/agents/bug-analyzer.md +0 -381
  210. package/.claude/agents/checklist-agent.md +0 -175
  211. package/.claude/agents/clarify-analyst.md +0 -50
  212. package/.claude/agents/code-quality-reviewer.md +0 -205
  213. package/.claude/agents/code-reviewer.md +0 -71
  214. package/.claude/agents/codex-analyzer.md +0 -39
  215. package/.claude/agents/compatibility-checker.md +0 -579
  216. package/.claude/agents/consistency-checker.md +0 -532
  217. package/.claude/agents/dev-implementer.md +0 -195
  218. package/.claude/agents/flow-researcher.md +0 -132
  219. package/.claude/agents/impact-analyzer.md +0 -440
  220. package/.claude/agents/planner.md +0 -230
  221. package/.claude/agents/prd-writer.md +0 -320
  222. package/.claude/agents/project-guidelines-generator.md +0 -1329
  223. package/.claude/agents/qa-tester.md +0 -313
  224. package/.claude/agents/release-manager.md +0 -295
  225. package/.claude/agents/security-reviewer.md +0 -314
  226. package/.claude/agents/spec-reviewer.md +0 -221
  227. package/.claude/agents/style-guide-generator.md +0 -458
  228. package/.claude/agents/tech-architect.md +0 -516
  229. package/.claude/agents/ui-designer.md +0 -485
  230. package/.claude/commands/core/architecture.md +0 -459
  231. package/.claude/commands/core/guidelines.md +0 -511
  232. package/.claude/commands/core/roadmap.md +0 -468
  233. package/.claude/commands/core/style.md +0 -83
  234. package/.claude/commands/flow/CLAUDE.md +0 -28
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/checklist.md +0 -18
  237. package/.claude/commands/flow/clarify.md +0 -18
  238. package/.claude/commands/flow/constitution.md +0 -82
  239. package/.claude/commands/flow/context.md +0 -150
  240. package/.claude/commands/flow/delta.md +0 -245
  241. package/.claude/commands/flow/dev.md +0 -40
  242. package/.claude/commands/flow/fix.md +0 -217
  243. package/.claude/commands/flow/ideate.md +0 -214
  244. package/.claude/commands/flow/init.md +0 -38
  245. package/.claude/commands/flow/new.md +0 -23
  246. package/.claude/commands/flow/quality.md +0 -21
  247. package/.claude/commands/flow/release.md +0 -36
  248. package/.claude/commands/flow/restart.md +0 -97
  249. package/.claude/commands/flow/spec.md +0 -36
  250. package/.claude/commands/flow/status.md +0 -64
  251. package/.claude/commands/flow/update.md +0 -111
  252. package/.claude/commands/flow/upgrade.md +0 -115
  253. package/.claude/commands/flow/verify.md +0 -37
  254. package/.claude/commands/flow/workspace.md +0 -155
  255. package/.claude/commands/util/cancel-ralph.md +0 -60
  256. package/.claude/commands/util/code-review.md +0 -58
  257. package/.claude/commands/util/git-commit.md +0 -422
  258. package/.claude/commands/util/problem-analyzer.md +0 -60
  259. package/.claude/config/quality-gates.yml +0 -305
  260. package/.claude/config/quality-rules.yml +0 -161
  261. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  262. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  263. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  264. package/.claude/docs/design/prd-version-management-design.md +0 -437
  265. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  266. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  267. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  268. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  269. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  270. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -633
  271. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  272. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  273. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  274. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  275. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  276. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  277. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  278. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  279. package/.claude/docs/templates/EPIC_TEMPLATE.md +0 -805
  280. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  281. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  282. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  283. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  284. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  285. package/.claude/docs/templates/PRD_TEMPLATE.md +0 -562
  286. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  287. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  288. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  289. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  290. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -1266
  291. package/.claude/docs/templates/TASKS_TEMPLATE.md +0 -523
  292. package/.claude/docs/templates/TECH_DESIGN_TEMPLATE.md +0 -1019
  293. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -1435
  294. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  295. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  296. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  297. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  298. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  299. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  300. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  301. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  303. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  304. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  305. package/.claude/guides/project-guidelines-system.md +0 -463
  306. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  307. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  308. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  309. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  310. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  311. package/.claude/hooks/CLAUDE.md +0 -342
  312. package/.claude/hooks/checklist-gate.js +0 -397
  313. package/.claude/hooks/error-handling-reminder.sh +0 -12
  314. package/.claude/hooks/error-handling-reminder.ts +0 -459
  315. package/.claude/hooks/hooks.json +0 -15
  316. package/.claude/hooks/inject-agent-context.ts +0 -480
  317. package/.claude/hooks/inject-skill-context.ts +0 -359
  318. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  319. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  320. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  321. package/.claude/hooks/ralph-loop.ts +0 -931
  322. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  323. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  324. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  325. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  326. package/.claude/hooks/task-completed-hook.ts +0 -593
  327. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  328. package/.claude/hooks/types/team-types.d.ts +0 -238
  329. package/.claude/rules/devflow-conventions.md +0 -286
  330. package/.claude/rules/project-constitution.md +0 -1002
  331. package/.claude/rules/rationalization-library.md +0 -282
  332. package/.claude/schemas/constitution.schema.json +0 -43
  333. package/.claude/scripts/CLAUDE.md +0 -76
  334. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  335. package/.claude/scripts/archive-requirement.sh +0 -394
  336. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  337. package/.claude/scripts/calculate-quarter.sh +0 -206
  338. package/.claude/scripts/check-dependencies.sh +0 -409
  339. package/.claude/scripts/check-prerequisites.sh +0 -232
  340. package/.claude/scripts/check-task-status.sh +0 -288
  341. package/.claude/scripts/checklist-errors.sh +0 -131
  342. package/.claude/scripts/common.sh +0 -1102
  343. package/.claude/scripts/consolidate-research.sh +0 -182
  344. package/.claude/scripts/create-requirement.sh +0 -451
  345. package/.claude/scripts/delta-parser.ts +0 -527
  346. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  347. package/.claude/scripts/export-contracts.sh +0 -117
  348. package/.claude/scripts/extract-data-model.sh +0 -78
  349. package/.claude/scripts/flow-context-add.sh +0 -134
  350. package/.claude/scripts/flow-context-init.sh +0 -133
  351. package/.claude/scripts/flow-context-validate.sh +0 -144
  352. package/.claude/scripts/flow-delta-apply.sh +0 -297
  353. package/.claude/scripts/flow-delta-archive.sh +0 -71
  354. package/.claude/scripts/flow-delta-create.sh +0 -202
  355. package/.claude/scripts/flow-delta-list.sh +0 -142
  356. package/.claude/scripts/flow-delta-status.sh +0 -235
  357. package/.claude/scripts/flow-quality-full.sh +0 -215
  358. package/.claude/scripts/flow-quality-quick.sh +0 -119
  359. package/.claude/scripts/flow-workspace-init.sh +0 -117
  360. package/.claude/scripts/flow-workspace-record.sh +0 -164
  361. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  362. package/.claude/scripts/generate-clarification-report.sh +0 -463
  363. package/.claude/scripts/generate-quickstart.sh +0 -146
  364. package/.claude/scripts/generate-research-tasks.sh +0 -157
  365. package/.claude/scripts/generate-status-report.sh +0 -523
  366. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  367. package/.claude/scripts/get-workflow-status.sh +0 -415
  368. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  369. package/.claude/scripts/manage-constitution.sh +0 -602
  370. package/.claude/scripts/mark-task-complete.sh +0 -198
  371. package/.claude/scripts/parse-task-dependencies.js +0 -334
  372. package/.claude/scripts/populate-research-tasks.sh +0 -284
  373. package/.claude/scripts/record-quality-error.sh +0 -165
  374. package/.claude/scripts/recover-workflow.sh +0 -463
  375. package/.claude/scripts/run-clarify-scan.sh +0 -601
  376. package/.claude/scripts/run-high-review.sh +0 -62
  377. package/.claude/scripts/run-problem-analysis.sh +0 -68
  378. package/.claude/scripts/run-quality-gates.sh +0 -242
  379. package/.claude/scripts/setup-epic.sh +0 -173
  380. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  381. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  382. package/.claude/scripts/sync-task-marks.sh +0 -199
  383. package/.claude/scripts/team-dev-init.sh +0 -319
  384. package/.claude/scripts/team-state-recovery.sh +0 -229
  385. package/.claude/scripts/test-clarify-scan.sh +0 -515
  386. package/.claude/scripts/update-agent-context.sh +0 -806
  387. package/.claude/scripts/validate-constitution.sh +0 -567
  388. package/.claude/scripts/validate-hooks.sh +0 -487
  389. package/.claude/scripts/validate-research.sh +0 -332
  390. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  391. package/.claude/scripts/verify-gate.sh +0 -269
  392. package/.claude/scripts/verify-setup.sh +0 -37
  393. package/.claude/scripts/workflow-status.ts +0 -433
  394. package/.claude/settings.json +0 -95
  395. package/.claude/skills/_reference-implementations/README.md +0 -96
  396. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  397. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  398. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  399. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  400. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  401. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  402. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  408. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  409. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  410. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  411. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  412. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  413. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  414. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  419. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  420. package/.claude/skills/domain/attention-refresh/SKILL.md +0 -170
  421. package/.claude/skills/domain/brainstorming/SKILL.md +0 -161
  422. package/.claude/skills/domain/debugging/SKILL.md +0 -221
  423. package/.claude/skills/domain/finishing-branch/SKILL.md +0 -189
  424. package/.claude/skills/domain/receiving-review/SKILL.md +0 -153
  425. package/.claude/skills/domain/tdd/SKILL.md +0 -218
  426. package/.claude/skills/domain/verification/SKILL.md +0 -158
  427. package/.claude/skills/guardrail/constitution-guardian/SKILL.md +0 -306
  428. package/.claude/skills/guardrail/tdd-enforcer/SKILL.md +0 -192
  429. package/.claude/skills/skill-rules.json +0 -359
  430. package/.claude/skills/utility/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/utility/file-standards/SKILL.md +0 -353
  432. package/.claude/skills/utility/fractal-docs/SKILL.md +0 -45
  433. package/.claude/skills/utility/journey-checker/SKILL.md +0 -199
  434. package/.claude/skills/utility/journey-checker/pressure-scenarios.md +0 -164
  435. package/.claude/skills/utility/npm-release/SKILL.md +0 -314
  436. package/.claude/skills/utility/skill-creator/LICENSE.txt +0 -202
  437. package/.claude/skills/utility/skill-creator/SKILL.md +0 -356
  438. package/.claude/skills/utility/skill-creator/references/output-patterns.md +0 -82
  439. package/.claude/skills/utility/skill-creator/references/workflows.md +0 -28
  440. package/.claude/skills/utility/skill-creator/scripts/init_skill.py +0 -303
  441. package/.claude/skills/utility/skill-creator/scripts/package_skill.py +0 -110
  442. package/.claude/skills/utility/skill-creator/scripts/quick_validate.py +0 -95
  443. package/.claude/skills/workflow/CLAUDE.md +0 -24
  444. package/.claude/skills/workflow/flow-dev/CLAUDE.md +0 -16
  445. package/.claude/skills/workflow/flow-dev/SKILL.md +0 -94
  446. package/.claude/skills/workflow/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  447. package/.claude/skills/workflow/flow-dev/context.jsonl +0 -4
  448. package/.claude/skills/workflow/flow-dev/dev-implementer.jsonl +0 -8
  449. package/.claude/skills/workflow/flow-dev/scripts/entry-gate.sh +0 -116
  450. package/.claude/skills/workflow/flow-dev/scripts/exit-gate.sh +0 -101
  451. package/.claude/skills/workflow/flow-dev/scripts/task-orchestrator.sh +0 -106
  452. package/.claude/skills/workflow/flow-fix/SKILL.md +0 -105
  453. package/.claude/skills/workflow/flow-fix/context.jsonl +0 -6
  454. package/.claude/skills/workflow/flow-fix/references/bug-analyzer.md +0 -381
  455. package/.claude/skills/workflow/flow-init/SKILL.md +0 -84
  456. package/.claude/skills/workflow/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  457. package/.claude/skills/workflow/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  458. package/.claude/skills/workflow/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  459. package/.claude/skills/workflow/flow-init/context.jsonl +0 -5
  460. package/.claude/skills/workflow/flow-init/references/flow-researcher.md +0 -132
  461. package/.claude/skills/workflow/flow-init/scripts/check-prerequisites.sh +0 -240
  462. package/.claude/skills/workflow/flow-init/scripts/consolidate-research.sh +0 -182
  463. package/.claude/skills/workflow/flow-init/scripts/create-requirement.sh +0 -404
  464. package/.claude/skills/workflow/flow-init/scripts/generate-research-tasks.sh +0 -157
  465. package/.claude/skills/workflow/flow-init/scripts/populate-research-tasks.sh +0 -284
  466. package/.claude/skills/workflow/flow-init/scripts/validate-research.sh +0 -340
  467. package/.claude/skills/workflow/flow-quality/SKILL.md +0 -98
  468. package/.claude/skills/workflow/flow-quality/context.jsonl +0 -6
  469. package/.claude/skills/workflow/flow-quality/references/code-quality-reviewer.md +0 -205
  470. package/.claude/skills/workflow/flow-quality/references/qa-tester.md +0 -313
  471. package/.claude/skills/workflow/flow-quality/references/security-reviewer.md +0 -314
  472. package/.claude/skills/workflow/flow-quality/references/spec-reviewer.md +0 -221
  473. package/.claude/skills/workflow/flow-release/SKILL.md +0 -49
  474. package/.claude/skills/workflow/flow-release/context.jsonl +0 -5
  475. package/.claude/skills/workflow/flow-release/references/release-manager.md +0 -295
  476. package/.claude/skills/workflow/flow-spec/CLAUDE.md +0 -17
  477. package/.claude/skills/workflow/flow-spec/SKILL.md +0 -74
  478. package/.claude/skills/workflow/flow-spec/context.jsonl +0 -5
  479. package/.claude/skills/workflow/flow-spec/scripts/entry-gate.sh +0 -194
  480. package/.claude/skills/workflow/flow-spec/scripts/exit-gate.sh +0 -244
  481. package/.claude/skills/workflow/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  482. package/.claude/skills/workflow/flow-spec/scripts/team-communication.sh +0 -353
  483. package/.claude/skills/workflow/flow-spec/scripts/team-init.sh +0 -195
  484. package/.claude/skills/workflow/flow-spec/scripts/test-team-mode.sh +0 -496
  485. package/.claude/skills/workflow/flow-spec/team-config.json +0 -165
  486. package/.claude/skills/workflow/flow-verify/CLAUDE.md +0 -10
  487. package/.claude/skills/workflow/flow-verify/SKILL.md +0 -53
  488. package/.claude/skills/workflow/flow-verify/context.jsonl +0 -5
  489. package/.claude/skills/workflow.yaml +0 -219
  490. package/.claude/tests/README.md +0 -300
  491. package/.claude/tests/TODO.md +0 -69
  492. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  493. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  494. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  495. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  496. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  497. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  498. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  499. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  500. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  501. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  502. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  503. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  504. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  505. package/.claude/tests/run-all-tests.sh +0 -229
  506. package/.claude/tests/scripts/run.sh +0 -30
  507. package/.claude/tests/scripts/test-framework.sh +0 -128
  508. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  509. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  510. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  511. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  512. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  513. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  514. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  515. package/.claude/tests/scripts/test_common.sh +0 -244
  516. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  517. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  518. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  519. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  520. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  521. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  522. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  523. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  524. package/.claude/tests/slugify.bats +0 -82
  525. package/.claude/tests/test-framework.sh +0 -732
  526. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  527. package/.claude/tests/test_consolidate_research.py +0 -48
  528. package/.claude/tests/test_export_contracts.py +0 -43
  529. package/.claude/tests/test_extract_data_model.py +0 -33
  530. package/.claude/tests/test_generate_quickstart.py +0 -50
  531. package/.claude/tests/test_generate_research_tasks.py +0 -52
  532. package/bin/harness.js +0 -22
  533. package/docs/commands/core-roadmap.md +0 -106
  534. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  535. package/docs/commands/core-style.md +0 -53
  536. package/docs/commands/core-style.zh-CN.md +0 -53
  537. package/docs/commands/flow-init.md +0 -140
  538. package/docs/commands/flow-init.zh-CN.md +0 -169
  539. package/docs/commands/flow-new.md +0 -39
  540. package/docs/commands/flow-new.zh-CN.md +0 -39
  541. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  542. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  543. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  544. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  545. package/lib/compiler/context-expander.js +0 -179
  546. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  547. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  548. package/lib/compiler/skill-discovery.js +0 -68
  549. package/lib/harness/CLAUDE.md +0 -21
  550. package/lib/harness/cli.js +0 -208
  551. package/lib/harness/index.js +0 -16
  552. package/lib/harness/operations/dispatch.js +0 -285
  553. package/lib/harness/operations/init.js +0 -48
  554. package/lib/harness/operations/pack.js +0 -100
  555. package/lib/harness/operations/plan.js +0 -29
  556. package/lib/harness/operations/resume.js +0 -44
  557. package/lib/harness/operations/verify.js +0 -163
  558. package/lib/harness/planner.js +0 -141
  559. package/lib/harness/schemas.js +0 -108
@@ -1,46 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
-
4
- usage() {
5
- cat <<'USAGE'
6
- Usage: .claude/scripts/generate-tech-analysis.sh <requirement-dir>
7
-
8
- Generates a placeholder codebase tech analysis report at
9
- research/codebase-tech-analysis.md.
10
- USAGE
11
- }
12
-
13
- if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
14
- usage
15
- exit 0
16
- fi
17
-
18
- if [[ $# -lt 1 ]]; then
19
- echo "Error: requirement directory is required." >&2
20
- usage
21
- exit 1
22
- fi
23
-
24
- REQ_DIR="$1"
25
- if [[ ! -d "$REQ_DIR" ]]; then
26
- echo "Error: requirement directory '$REQ_DIR' does not exist." >&2
27
- exit 1
28
- fi
29
-
30
- REPORT="${REQ_DIR}/research/codebase-tech-analysis.md"
31
- mkdir -p "${REQ_DIR}/research"
32
-
33
- cat >"$REPORT" <<'REPORT'
34
- # Codebase Technical Analysis (Placeholder)
35
-
36
- _TODO: Replace with automated analysis output._
37
-
38
- - Data model patterns: TBD
39
- - API implementation patterns: TBD
40
- - Auth/security patterns: TBD
41
- - Database interactions: TBD
42
- - Reusable components: TBD
43
- - Testing strategy: TBD
44
- REPORT
45
-
46
- echo "Wrote placeholder tech analysis → $REPORT"
@@ -1,415 +0,0 @@
1
- #!/usr/bin/env bash
2
- # =============================================================================
3
- # get-workflow-status.sh - 工作流状态检测脚本
4
- # =============================================================================
5
- # 读取 workflow.yaml,检查工件文件存在性,输出当前状态和可执行的下一步
6
- #
7
- # 用法:
8
- # ./get-workflow-status.sh REQ-001 # 检查指定需求的状态
9
- # ./get-workflow-status.sh REQ-001 --json # JSON 格式输出
10
- # ./get-workflow-status.sh REQ-001 --next # 仅输出下一步可执行的工件
11
- # ./get-workflow-status.sh --project # 检查项目级工件状态
12
- #
13
- # [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
14
- # =============================================================================
15
-
16
- set -euo pipefail
17
-
18
- # -----------------------------------------------------------------------------
19
- # 配置
20
- # -----------------------------------------------------------------------------
21
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
22
- PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
23
- WORKFLOW_YAML="${PROJECT_ROOT}/.claude/skills/workflow.yaml"
24
-
25
- # 颜色定义
26
- RED='\033[0;31m'
27
- GREEN='\033[0;32m'
28
- YELLOW='\033[0;33m'
29
- BLUE='\033[0;34m'
30
- CYAN='\033[0;36m'
31
- NC='\033[0m' # No Color
32
-
33
- # -----------------------------------------------------------------------------
34
- # 辅助函数
35
- # -----------------------------------------------------------------------------
36
- log_info() { echo -e "${BLUE}[INFO]${NC} $*"; }
37
- log_success() { echo -e "${GREEN}[DONE]${NC} $*"; }
38
- log_warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
39
- log_error() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
40
-
41
- # 检查依赖
42
- check_dependencies() {
43
- local missing=()
44
- for cmd in yq; do
45
- if ! command -v "$cmd" &>/dev/null; then
46
- missing+=("$cmd")
47
- fi
48
- done
49
- if [[ ${#missing[@]} -gt 0 ]]; then
50
- log_error "缺少依赖: ${missing[*]}"
51
- log_info "安装方法: brew install ${missing[*]}"
52
- exit 1
53
- fi
54
- }
55
-
56
- # 替换路径中的占位符
57
- resolve_path() {
58
- local path="$1"
59
- local req_id="${2:-}"
60
- local bug_id="${3:-}"
61
-
62
- path="${path//\{REQ\}/$req_id}"
63
- path="${path//\{BUG\}/$bug_id}"
64
- echo "$path"
65
- }
66
-
67
- # 检查文件/目录是否存在(支持 glob)
68
- check_exists() {
69
- local pattern="$1"
70
- local is_glob="${2:-false}"
71
- local full_path="${PROJECT_ROOT}/${pattern}"
72
-
73
- if [[ "$is_glob" == "true" ]]; then
74
- # glob 模式:检查是否有匹配的文件
75
- local matches
76
- matches=$(find "${full_path%/*}" -name "${full_path##*/}" 2>/dev/null | head -1)
77
- [[ -n "$matches" ]]
78
- else
79
- # 精确路径:检查文件或目录存在
80
- [[ -e "$full_path" ]]
81
- fi
82
- }
83
-
84
- # 检查工件是否完成
85
- is_artifact_complete() {
86
- local generates="$1"
87
- local req_id="$2"
88
- local is_glob="${3:-false}"
89
-
90
- local resolved_path
91
- resolved_path=$(resolve_path "$generates" "$req_id")
92
-
93
- check_exists "$resolved_path" "$is_glob"
94
- }
95
-
96
- # 检查依赖是否满足
97
- are_dependencies_met() {
98
- local artifact_id="$1"
99
- local req_id="$2"
100
-
101
- # 获取依赖列表
102
- local requires
103
- requires=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .requires[]?" "$WORKFLOW_YAML" 2>/dev/null)
104
-
105
- if [[ -z "$requires" ]]; then
106
- return 0 # 无依赖,满足
107
- fi
108
-
109
- # 检查每个依赖
110
- while IFS= read -r dep_id; do
111
- [[ -z "$dep_id" ]] && continue
112
-
113
- local dep_generates dep_glob
114
- dep_generates=$(yq ".artifacts[] | select(.id == \"$dep_id\") | .generates" "$WORKFLOW_YAML")
115
- dep_glob=$(yq ".artifacts[] | select(.id == \"$dep_id\") | .glob // false" "$WORKFLOW_YAML")
116
-
117
- if ! is_artifact_complete "$dep_generates" "$req_id" "$dep_glob"; then
118
- return 1 # 依赖未完成
119
- fi
120
- done <<< "$requires"
121
-
122
- return 0 # 所有依赖满足
123
- }
124
-
125
- # 获取工件状态
126
- get_artifact_status() {
127
- local artifact_id="$1"
128
- local req_id="$2"
129
-
130
- local generates is_glob is_optional
131
- generates=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .generates" "$WORKFLOW_YAML")
132
- is_glob=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .glob // false" "$WORKFLOW_YAML")
133
- is_optional=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .optional // false" "$WORKFLOW_YAML")
134
-
135
- if is_artifact_complete "$generates" "$req_id" "$is_glob"; then
136
- echo "complete"
137
- elif are_dependencies_met "$artifact_id" "$req_id"; then
138
- echo "ready"
139
- else
140
- echo "blocked"
141
- fi
142
- }
143
-
144
- # -----------------------------------------------------------------------------
145
- # 主要功能
146
- # -----------------------------------------------------------------------------
147
-
148
- # 获取需求级工件状态
149
- get_requirement_status() {
150
- local req_id="$1"
151
- local output_format="${2:-text}"
152
-
153
- log_info "检查需求 $req_id 的工作流状态..."
154
-
155
- # 获取所有需求级工件(包含 {REQ} 占位符的)
156
- local artifacts
157
- artifacts=$(yq '.artifacts[] | select(.generates | contains("{REQ}")) | .id' "$WORKFLOW_YAML")
158
-
159
- local complete=()
160
- local ready=()
161
- local blocked=()
162
- local optional_pending=()
163
-
164
- while IFS= read -r artifact_id; do
165
- [[ -z "$artifact_id" ]] && continue
166
-
167
- local status is_optional
168
- status=$(get_artifact_status "$artifact_id" "$req_id")
169
- is_optional=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .optional // false" "$WORKFLOW_YAML")
170
-
171
- case "$status" in
172
- complete)
173
- complete+=("$artifact_id")
174
- ;;
175
- ready)
176
- if [[ "$is_optional" == "true" ]]; then
177
- optional_pending+=("$artifact_id")
178
- else
179
- ready+=("$artifact_id")
180
- fi
181
- ;;
182
- blocked)
183
- blocked+=("$artifact_id")
184
- ;;
185
- esac
186
- done <<< "$artifacts"
187
-
188
- # 输出结果
189
- if [[ "$output_format" == "json" ]]; then
190
- cat <<EOF
191
- {
192
- "req_id": "$req_id",
193
- "complete": [$(printf '"%s",' "${complete[@]}" | sed 's/,$//')]
194
- "ready": [$(printf '"%s",' "${ready[@]}" | sed 's/,$//')]
195
- "optional_pending": [$(printf '"%s",' "${optional_pending[@]}" | sed 's/,$//')]
196
- "blocked": [$(printf '"%s",' "${blocked[@]}" | sed 's/,$//')]
197
- "progress": "${#complete[@]}/$((${#complete[@]} + ${#ready[@]} + ${#blocked[@]}))"
198
- }
199
- EOF
200
- else
201
- echo ""
202
- echo -e "${CYAN}=== 需求 $req_id 工作流状态 ===${NC}"
203
- echo ""
204
-
205
- if [[ ${#complete[@]} -gt 0 ]]; then
206
- echo -e "${GREEN}已完成 (${#complete[@]}):${NC}"
207
- for a in "${complete[@]}"; do
208
- local generates
209
- generates=$(yq ".artifacts[] | select(.id == \"$a\") | .generates" "$WORKFLOW_YAML")
210
- generates=$(resolve_path "$generates" "$req_id")
211
- echo -e " ${GREEN}✓${NC} $a → $generates"
212
- done
213
- echo ""
214
- fi
215
-
216
- if [[ ${#ready[@]} -gt 0 ]]; then
217
- echo -e "${YELLOW}可执行 (${#ready[@]}):${NC}"
218
- for a in "${ready[@]}"; do
219
- local skill
220
- skill=$(yq ".artifacts[] | select(.id == \"$a\") | .skill" "$WORKFLOW_YAML")
221
- echo -e " ${YELLOW}→${NC} $a (skill: $skill)"
222
- done
223
- echo ""
224
- fi
225
-
226
- if [[ ${#optional_pending[@]} -gt 0 ]]; then
227
- echo -e "${BLUE}可选工件 (${#optional_pending[@]}):${NC}"
228
- for a in "${optional_pending[@]}"; do
229
- local skill
230
- skill=$(yq ".artifacts[] | select(.id == \"$a\") | .skill" "$WORKFLOW_YAML")
231
- echo -e " ${BLUE}○${NC} $a (skill: $skill)"
232
- done
233
- echo ""
234
- fi
235
-
236
- if [[ ${#blocked[@]} -gt 0 ]]; then
237
- echo -e "${RED}阻塞中 (${#blocked[@]}):${NC}"
238
- for a in "${blocked[@]}"; do
239
- local requires
240
- requires=$(yq ".artifacts[] | select(.id == \"$a\") | .requires[]?" "$WORKFLOW_YAML" | tr '\n' ', ' | sed 's/,$//')
241
- echo -e " ${RED}✗${NC} $a (等待: $requires)"
242
- done
243
- echo ""
244
- fi
245
-
246
- # 进度条
247
- local total=$((${#complete[@]} + ${#ready[@]} + ${#blocked[@]}))
248
- local percent=0
249
- [[ $total -gt 0 ]] && percent=$((${#complete[@]} * 100 / total))
250
- echo -e "进度: ${GREEN}${#complete[@]}${NC}/$total ($percent%)"
251
-
252
- # 下一步建议
253
- if [[ ${#ready[@]} -gt 0 ]]; then
254
- local next_artifact="${ready[0]}"
255
- local next_skill
256
- next_skill=$(yq ".artifacts[] | select(.id == \"$next_artifact\") | .skill" "$WORKFLOW_YAML")
257
- echo ""
258
- echo -e "${CYAN}建议下一步:${NC} /$next_skill \"$req_id\""
259
- fi
260
- fi
261
- }
262
-
263
- # 获取项目级工件状态
264
- get_project_status() {
265
- local output_format="${1:-text}"
266
-
267
- log_info "检查项目级工件状态..."
268
-
269
- # 获取所有项目级工件(不包含 {REQ} 占位符的)
270
- local artifacts
271
- artifacts=$(yq '.artifacts[] | select(.generates | contains("{REQ}") | not) | select(.generates | contains("{BUG}") | not) | .id' "$WORKFLOW_YAML")
272
-
273
- local complete=()
274
- local missing=()
275
-
276
- while IFS= read -r artifact_id; do
277
- [[ -z "$artifact_id" ]] && continue
278
-
279
- local generates
280
- generates=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .generates" "$WORKFLOW_YAML")
281
-
282
- if check_exists "$generates" "false"; then
283
- complete+=("$artifact_id")
284
- else
285
- missing+=("$artifact_id")
286
- fi
287
- done <<< "$artifacts"
288
-
289
- # 输出结果
290
- if [[ "$output_format" == "json" ]]; then
291
- cat <<EOF
292
- {
293
- "type": "project",
294
- "complete": [$(printf '"%s",' "${complete[@]}" | sed 's/,$//')]
295
- "missing": [$(printf '"%s",' "${missing[@]}" | sed 's/,$//')]
296
- }
297
- EOF
298
- else
299
- echo ""
300
- echo -e "${CYAN}=== 项目级工件状态 ===${NC}"
301
- echo ""
302
-
303
- if [[ ${#complete[@]} -gt 0 ]]; then
304
- echo -e "${GREEN}已完成 (${#complete[@]}):${NC}"
305
- for a in "${complete[@]}"; do
306
- local generates
307
- generates=$(yq ".artifacts[] | select(.id == \"$a\") | .generates" "$WORKFLOW_YAML")
308
- echo -e " ${GREEN}✓${NC} $a → $generates"
309
- done
310
- echo ""
311
- fi
312
-
313
- if [[ ${#missing[@]} -gt 0 ]]; then
314
- echo -e "${YELLOW}缺失 (${#missing[@]}):${NC}"
315
- for a in "${missing[@]}"; do
316
- local skill generates
317
- skill=$(yq ".artifacts[] | select(.id == \"$a\") | .skill" "$WORKFLOW_YAML")
318
- generates=$(yq ".artifacts[] | select(.id == \"$a\") | .generates" "$WORKFLOW_YAML")
319
- echo -e " ${YELLOW}○${NC} $a → $generates (skill: $skill)"
320
- done
321
- fi
322
- fi
323
- }
324
-
325
- # 仅输出下一步可执行的工件
326
- get_next_actions() {
327
- local req_id="$1"
328
-
329
- local artifacts
330
- artifacts=$(yq '.artifacts[] | select(.generates | contains("{REQ}")) | .id' "$WORKFLOW_YAML")
331
-
332
- while IFS= read -r artifact_id; do
333
- [[ -z "$artifact_id" ]] && continue
334
-
335
- local status is_optional
336
- status=$(get_artifact_status "$artifact_id" "$req_id")
337
- is_optional=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .optional // false" "$WORKFLOW_YAML")
338
-
339
- if [[ "$status" == "ready" && "$is_optional" != "true" ]]; then
340
- local skill
341
- skill=$(yq ".artifacts[] | select(.id == \"$artifact_id\") | .skill" "$WORKFLOW_YAML")
342
- echo "$artifact_id:$skill"
343
- fi
344
- done <<< "$artifacts"
345
- }
346
-
347
- # -----------------------------------------------------------------------------
348
- # 主入口
349
- # -----------------------------------------------------------------------------
350
- main() {
351
- check_dependencies
352
-
353
- local req_id=""
354
- local output_format="text"
355
- local mode="requirement"
356
-
357
- # 解析参数
358
- while [[ $# -gt 0 ]]; do
359
- case "$1" in
360
- --json)
361
- output_format="json"
362
- shift
363
- ;;
364
- --next)
365
- mode="next"
366
- shift
367
- ;;
368
- --project)
369
- mode="project"
370
- shift
371
- ;;
372
- -h|--help)
373
- echo "用法: $0 [REQ-ID] [选项]"
374
- echo ""
375
- echo "选项:"
376
- echo " --json JSON 格式输出"
377
- echo " --next 仅输出下一步可执行的工件"
378
- echo " --project 检查项目级工件状态"
379
- echo " -h, --help 显示帮助"
380
- exit 0
381
- ;;
382
- REQ-*)
383
- req_id="$1"
384
- shift
385
- ;;
386
- *)
387
- log_error "未知参数: $1"
388
- exit 1
389
- ;;
390
- esac
391
- done
392
-
393
- # 执行
394
- case "$mode" in
395
- project)
396
- get_project_status "$output_format"
397
- ;;
398
- next)
399
- if [[ -z "$req_id" ]]; then
400
- log_error "需要指定 REQ-ID"
401
- exit 1
402
- fi
403
- get_next_actions "$req_id"
404
- ;;
405
- requirement)
406
- if [[ -z "$req_id" ]]; then
407
- log_error "需要指定 REQ-ID 或使用 --project"
408
- exit 1
409
- fi
410
- get_requirement_status "$req_id" "$output_format"
411
- ;;
412
- esac
413
- }
414
-
415
- main "$@"
@@ -1,233 +0,0 @@
1
- #!/usr/bin/env bash
2
- # Locate a requirement's position in the roadmap
3
- # Given a REQ-ID, finds its corresponding RM-ID, milestone, quarter, and cluster
4
- # Usage: ./locate-requirement-in-roadmap.sh [REQ-ID]
5
- # If REQ-ID not provided, uses current requirement from branch/environment
6
-
7
- set -euo pipefail
8
-
9
- # =============================================================================
10
- # 获取当前脚本所在目录
11
- # =============================================================================
12
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
13
-
14
- # Source common functions
15
- if [[ -f "$SCRIPT_DIR/common.sh" ]]; then
16
- source "$SCRIPT_DIR/common.sh"
17
- fi
18
-
19
- # =============================================================================
20
- # Roadmap Parsing Functions (路线图解析函数)
21
- # =============================================================================
22
-
23
- # Find RM-ID for a given REQ-ID in ROADMAP.md
24
- # Args: $1 = ROADMAP.md path, $2 = REQ-ID
25
- # Returns: RM-ID or empty string
26
- find_rm_id() {
27
- local roadmap_file="$1"
28
- local req_id="$2"
29
-
30
- if [[ ! -f "$roadmap_file" ]]; then
31
- return 1
32
- fi
33
-
34
- # Search Implementation Tracking table for REQ-ID
35
- # Format: | RM-XXX | Feature | Derived From | Status | REQ-XXX | Progress |
36
- local rm_id=$(grep -E "\\| (RM-[0-9]+) \\|.*\\| $req_id \\|" "$roadmap_file" | \
37
- grep -o "RM-[0-9]*" | head -1)
38
-
39
- echo "$rm_id"
40
- }
41
-
42
- # Find feature name for RM-ID
43
- # Args: $1 = ROADMAP.md path, $2 = RM-ID
44
- # Returns: Feature name
45
- find_feature_name() {
46
- local roadmap_file="$1"
47
- local rm_id="$2"
48
-
49
- if [[ ! -f "$roadmap_file" ]]; then
50
- return 1
51
- fi
52
-
53
- # Search Implementation Tracking table
54
- # Format: | RM-XXX | Feature | ... |
55
- local feature=$(grep -E "\\| $rm_id \\|" "$roadmap_file" | \
56
- sed -E 's/.*\| [^|]+ \| ([^|]+) \|.*/\1/' | \
57
- sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | \
58
- head -1)
59
-
60
- echo "$feature"
61
- }
62
-
63
- # Find milestone and quarter for RM-ID
64
- # Args: $1 = ROADMAP.md path, $2 = RM-ID
65
- # Returns: Milestone|Quarter|Cluster format
66
- find_milestone_info() {
67
- local roadmap_file="$1"
68
- local rm_id="$2"
69
-
70
- if [[ ! -f "$roadmap_file" ]]; then
71
- return 1
72
- fi
73
-
74
- # Search for RM-ID in quarterly sections
75
- # Pattern: **RM-XXX**: Title (Source)
76
- # First find which section it's in by looking backwards for headers
77
-
78
- local line_number=$(grep -n "\\*\\*$rm_id\\*\\*:" "$roadmap_file" | cut -d: -f1 | head -1)
79
-
80
- if [[ -z "$line_number" ]]; then
81
- echo "Unknown|Unknown|Unknown"
82
- return
83
- fi
84
-
85
- # Get all lines from start to this line
86
- local context=$(head -n "$line_number" "$roadmap_file")
87
-
88
- # Find last Quarter section header (e.g., "## Q4 2025 Milestones")
89
- local quarter=$(echo "$context" | grep -E "^## Q[0-9]+ [0-9]+ Milestones" | tail -1 | \
90
- sed -E 's/^## (Q[0-9]+ [0-9]+) Milestones/\1/')
91
-
92
- # Find last Milestone header (e.g., "### M1-Q4-2025: Milestone Name")
93
- local milestone=$(echo "$context" | grep -E "^### (M[0-9]+-Q[0-9]+-[0-9]+):" | tail -1 | \
94
- sed -E 's/^### ([^:]+):.*/\1/')
95
-
96
- # Find last Feature Cluster header (e.g., "**Feature Cluster 1: Cluster Name**")
97
- local cluster=$(echo "$context" | grep -E "^\*\*Feature Cluster [0-9]+: " | tail -1 | \
98
- sed -E 's/^\*\*Feature Cluster [0-9]+: ([^*]+)\*\*/\1/')
99
-
100
- echo "${milestone:-Unknown}|${quarter:-Unknown}|${cluster:-Unknown}"
101
- }
102
-
103
- # Get derived_from for RM-ID
104
- # Args: $1 = ROADMAP.md path, $2 = RM-ID
105
- # Returns: Derived From value
106
- find_derived_from() {
107
- local roadmap_file="$1"
108
- local rm_id="$2"
109
-
110
- if [[ ! -f "$roadmap_file" ]]; then
111
- return 1
112
- fi
113
-
114
- # Search Implementation Tracking table
115
- # Format: | RM-XXX | Feature | Derived From | ... |
116
- local derived=$(grep -E "\\| $rm_id \\|" "$roadmap_file" | \
117
- awk -F'|' '{print $4}' | \
118
- sed 's/^[[:space:]]*//;s/[[:space:]]*$//' | \
119
- head -1)
120
-
121
- echo "$derived"
122
- }
123
-
124
- # =============================================================================
125
- # Display Functions (显示函数)
126
- # =============================================================================
127
-
128
- # Display requirement location information
129
- # Args: $1 = REQ-ID, $2 = RM-ID, $3 = Feature, $4 = Milestone, $5 = Quarter, $6 = Cluster, $7 = Derived
130
- display_location() {
131
- local req_id="$1"
132
- local rm_id="$2"
133
- local feature="$3"
134
- local milestone="$4"
135
- local quarter="$5"
136
- local cluster="$6"
137
- local derived="$7"
138
-
139
- echo "==================================================================="
140
- echo "Requirement Location in Roadmap"
141
- echo "==================================================================="
142
- echo ""
143
- echo "📋 Requirement: $req_id"
144
- echo "🎯 Roadmap Item: $rm_id"
145
- echo "📝 Feature: $feature"
146
- echo "📌 Derived From: $derived"
147
- echo ""
148
- echo "📅 Timeline:"
149
- echo " Quarter: $quarter"
150
- echo " Milestone: $milestone"
151
- echo " Cluster: $cluster"
152
- echo ""
153
- echo "==================================================================="
154
- }
155
-
156
- # =============================================================================
157
- # Main Function (主函数)
158
- # =============================================================================
159
-
160
- main() {
161
- local req_id="${1:-}"
162
-
163
- # If no REQ-ID provided, try to get from current context
164
- if [[ -z "$req_id" ]]; then
165
- req_id=$(get_current_req_id)
166
- if [[ -z "$req_id" ]]; then
167
- echo "ERROR: No REQ-ID provided and cannot determine current requirement" >&2
168
- echo "Usage: $0 [REQ-ID]" >&2
169
- exit 1
170
- fi
171
- echo "Using current requirement: $req_id"
172
- echo ""
173
- fi
174
-
175
- # Validate REQ-ID format
176
- if ! validate_req_id "$req_id"; then
177
- exit 1
178
- fi
179
-
180
- # Get repo root and roadmap path
181
- local repo_root=$(get_repo_root)
182
- local roadmap_file="$repo_root/devflow/ROADMAP.md"
183
-
184
- # Check if ROADMAP.md exists
185
- if [[ ! -f "$roadmap_file" ]]; then
186
- echo "⚠️ ROADMAP.md not found at: $roadmap_file" >&2
187
- echo "" >&2
188
- echo "Please run /core-roadmap to create a roadmap first." >&2
189
- exit 1
190
- fi
191
-
192
- # Find RM-ID for this REQ-ID
193
- local rm_id=$(find_rm_id "$roadmap_file" "$req_id")
194
-
195
- if [[ -z "$rm_id" ]]; then
196
- echo "⚠️ Requirement $req_id not found in roadmap" >&2
197
- echo "" >&2
198
- echo "This requirement may be:" >&2
199
- echo " - Not yet added to the roadmap" >&2
200
- echo " - An ad-hoc requirement outside the roadmap" >&2
201
- echo " - Created before the roadmap was established" >&2
202
- echo "" >&2
203
- echo "You can:" >&2
204
- echo " 1. Run /core-roadmap to regenerate the roadmap" >&2
205
- echo " 2. Manually add this requirement to ROADMAP.md" >&2
206
- exit 1
207
- fi
208
-
209
- # Get feature name
210
- local feature=$(find_feature_name "$roadmap_file" "$rm_id")
211
-
212
- # Get milestone info
213
- local milestone_info=$(find_milestone_info "$roadmap_file" "$rm_id")
214
- local milestone=$(echo "$milestone_info" | cut -d'|' -f1)
215
- local quarter=$(echo "$milestone_info" | cut -d'|' -f2)
216
- local cluster=$(echo "$milestone_info" | cut -d'|' -f3)
217
-
218
- # Get derived_from
219
- local derived=$(find_derived_from "$roadmap_file" "$rm_id")
220
-
221
- # Display results
222
- display_location "$req_id" "$rm_id" "$feature" "$milestone" "$quarter" "$cluster" "$derived"
223
-
224
- # Return success
225
- exit 0
226
- }
227
-
228
- # =============================================================================
229
- # Script Entry Point (脚本入口)
230
- # =============================================================================
231
-
232
- # Run main function
233
- main "$@"