cc-devflow 4.3.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 (575) 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 +61 -4
  86. package/README.md +120 -756
  87. package/README.zh-CN.md +119 -756
  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 +60 -225
  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/skill-runtime/operations/release.js +96 -0
  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 -24
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/constitution.md +0 -82
  237. package/.claude/commands/flow/context.md +0 -150
  238. package/.claude/commands/flow/delta.md +0 -245
  239. package/.claude/commands/flow/dev.md +0 -40
  240. package/.claude/commands/flow/fix.md +0 -217
  241. package/.claude/commands/flow/ideate.md +0 -214
  242. package/.claude/commands/flow/init.md +0 -38
  243. package/.claude/commands/flow/release.md +0 -36
  244. package/.claude/commands/flow/restart.md +0 -97
  245. package/.claude/commands/flow/spec.md +0 -36
  246. package/.claude/commands/flow/status.md +0 -64
  247. package/.claude/commands/flow/update.md +0 -111
  248. package/.claude/commands/flow/upgrade.md +0 -115
  249. package/.claude/commands/flow/verify.md +0 -37
  250. package/.claude/commands/flow/workspace.md +0 -155
  251. package/.claude/commands/util/cancel-ralph.md +0 -60
  252. package/.claude/commands/util/code-review.md +0 -58
  253. package/.claude/commands/util/git-commit.md +0 -422
  254. package/.claude/commands/util/problem-analyzer.md +0 -60
  255. package/.claude/config/quality-gates.yml +0 -305
  256. package/.claude/config/quality-rules.yml +0 -161
  257. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  258. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  259. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  260. package/.claude/docs/design/prd-version-management-design.md +0 -437
  261. package/.claude/docs/examples/design-inspiration-pool.md +0 -59
  262. package/.claude/docs/examples/ui-prototype-constitution-checklist.md +0 -75
  263. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  264. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  265. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  266. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  267. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  268. package/.claude/docs/implementation-summary-v7.md +0 -449
  269. package/.claude/docs/spec-format-guide.md +0 -349
  270. package/.claude/docs/state-consolidation-design.md +0 -323
  271. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -332
  272. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  273. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  274. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  275. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  276. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  277. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  278. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  279. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  280. package/.claude/docs/templates/DESIGN_TEMPLATE.md +0 -157
  281. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  282. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  283. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  284. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  285. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  286. package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +0 -91
  287. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  288. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  289. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  290. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  291. package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +0 -139
  292. package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +0 -93
  293. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -479
  294. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -373
  295. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  296. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  297. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  298. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  299. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  300. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  301. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  303. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  304. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  305. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  306. package/.claude/guides/project-guidelines-system.md +0 -463
  307. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  308. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  309. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  310. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  311. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  312. package/.claude/hooks/CLAUDE.md +0 -342
  313. package/.claude/hooks/checklist-gate.js +0 -397
  314. package/.claude/hooks/error-handling-reminder.sh +0 -12
  315. package/.claude/hooks/error-handling-reminder.ts +0 -459
  316. package/.claude/hooks/hooks.json +0 -15
  317. package/.claude/hooks/inject-agent-context.ts +0 -480
  318. package/.claude/hooks/inject-skill-context.ts +0 -359
  319. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  320. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  321. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  322. package/.claude/hooks/ralph-loop.ts +0 -931
  323. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  324. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  325. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  326. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  327. package/.claude/hooks/task-completed-hook.ts +0 -593
  328. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  329. package/.claude/hooks/types/team-types.d.ts +0 -238
  330. package/.claude/rules/devflow-conventions.md +0 -286
  331. package/.claude/rules/project-constitution.md +0 -1002
  332. package/.claude/rules/rationalization-library.md +0 -282
  333. package/.claude/schemas/constitution.schema.json +0 -43
  334. package/.claude/scripts/.claude/commands/flow/export-openspec.md +0 -221
  335. package/.claude/scripts/.claude/commands/flow/import-openspec.md +0 -171
  336. package/.claude/scripts/CLAUDE.md +0 -76
  337. package/.claude/scripts/__tests__/openspec.test.js +0 -212
  338. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  339. package/.claude/scripts/archive-requirement.sh +0 -394
  340. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  341. package/.claude/scripts/calculate-quarter.sh +0 -206
  342. package/.claude/scripts/check-dependencies.sh +0 -409
  343. package/.claude/scripts/check-prerequisites.sh +0 -232
  344. package/.claude/scripts/check-task-status.sh +0 -288
  345. package/.claude/scripts/checklist-errors.sh +0 -131
  346. package/.claude/scripts/common.sh +0 -1102
  347. package/.claude/scripts/consolidate-research.sh +0 -182
  348. package/.claude/scripts/create-requirement.sh +0 -451
  349. package/.claude/scripts/delta-parser.ts +0 -637
  350. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  351. package/.claude/scripts/export-contracts.sh +0 -117
  352. package/.claude/scripts/export-openspec.js +0 -222
  353. package/.claude/scripts/extract-data-model.sh +0 -78
  354. package/.claude/scripts/flow-context-add.sh +0 -134
  355. package/.claude/scripts/flow-context-init.sh +0 -133
  356. package/.claude/scripts/flow-context-validate.sh +0 -144
  357. package/.claude/scripts/flow-delta-apply.sh +0 -297
  358. package/.claude/scripts/flow-delta-archive.sh +0 -71
  359. package/.claude/scripts/flow-delta-create.sh +0 -202
  360. package/.claude/scripts/flow-delta-list.sh +0 -142
  361. package/.claude/scripts/flow-delta-status.sh +0 -235
  362. package/.claude/scripts/flow-quality-full.sh +0 -215
  363. package/.claude/scripts/flow-quality-quick.sh +0 -119
  364. package/.claude/scripts/flow-workspace-init.sh +0 -117
  365. package/.claude/scripts/flow-workspace-record.sh +0 -164
  366. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  367. package/.claude/scripts/generate-clarification-report.sh +0 -463
  368. package/.claude/scripts/generate-quickstart.sh +0 -146
  369. package/.claude/scripts/generate-research-tasks.sh +0 -157
  370. package/.claude/scripts/generate-status-report.sh +0 -523
  371. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  372. package/.claude/scripts/get-workflow-status.sh +0 -415
  373. package/.claude/scripts/import-openspec.js +0 -272
  374. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  375. package/.claude/scripts/manage-constitution.sh +0 -602
  376. package/.claude/scripts/mark-task-complete.sh +0 -198
  377. package/.claude/scripts/parse-task-dependencies.js +0 -334
  378. package/.claude/scripts/populate-research-tasks.sh +0 -284
  379. package/.claude/scripts/record-quality-error.sh +0 -165
  380. package/.claude/scripts/recover-workflow.sh +0 -463
  381. package/.claude/scripts/run-clarify-scan.sh +0 -601
  382. package/.claude/scripts/run-high-review.sh +0 -62
  383. package/.claude/scripts/run-problem-analysis.sh +0 -68
  384. package/.claude/scripts/run-quality-gates.sh +0 -242
  385. package/.claude/scripts/setup-epic.sh +0 -173
  386. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  387. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  388. package/.claude/scripts/sync-task-marks.sh +0 -199
  389. package/.claude/scripts/team-dev-init.sh +0 -319
  390. package/.claude/scripts/team-state-recovery.sh +0 -229
  391. package/.claude/scripts/test-clarify-scan.sh +0 -515
  392. package/.claude/scripts/update-agent-context.sh +0 -806
  393. package/.claude/scripts/validate-constitution.sh +0 -567
  394. package/.claude/scripts/validate-hooks.sh +0 -487
  395. package/.claude/scripts/validate-research.sh +0 -332
  396. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  397. package/.claude/scripts/validate-scope.sh +0 -200
  398. package/.claude/scripts/verify-gate.sh +0 -269
  399. package/.claude/scripts/verify-setup.sh +0 -37
  400. package/.claude/scripts/workflow-status.ts +0 -433
  401. package/.claude/settings.json +0 -95
  402. package/.claude/skills/_reference-implementations/README.md +0 -96
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  408. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  409. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  410. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  411. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  412. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  413. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  414. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  419. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  420. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  421. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  422. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  423. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  424. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  425. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  426. package/.claude/skills/attention-refresh/SKILL.md +0 -170
  427. package/.claude/skills/brainstorming/SKILL.md +0 -161
  428. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  429. package/.claude/skills/constitution-guardian/SKILL.md +0 -306
  430. package/.claude/skills/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/debugging/SKILL.md +0 -221
  432. package/.claude/skills/file-standards/SKILL.md +0 -353
  433. package/.claude/skills/finishing-branch/SKILL.md +0 -189
  434. package/.claude/skills/flow-dev/CLAUDE.md +0 -16
  435. package/.claude/skills/flow-dev/SKILL.md +0 -94
  436. package/.claude/skills/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  437. package/.claude/skills/flow-dev/context.jsonl +0 -4
  438. package/.claude/skills/flow-dev/dev-implementer.jsonl +0 -8
  439. package/.claude/skills/flow-dev/scripts/entry-gate.sh +0 -116
  440. package/.claude/skills/flow-dev/scripts/exit-gate.sh +0 -101
  441. package/.claude/skills/flow-dev/scripts/task-orchestrator.sh +0 -106
  442. package/.claude/skills/flow-fix/SKILL.md +0 -105
  443. package/.claude/skills/flow-fix/context.jsonl +0 -6
  444. package/.claude/skills/flow-fix/references/bug-analyzer.md +0 -381
  445. package/.claude/skills/flow-init/SKILL.md +0 -105
  446. package/.claude/skills/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  447. package/.claude/skills/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  448. package/.claude/skills/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  449. package/.claude/skills/flow-init/context.jsonl +0 -5
  450. package/.claude/skills/flow-init/references/flow-researcher.md +0 -132
  451. package/.claude/skills/flow-init/scripts/check-prerequisites.sh +0 -240
  452. package/.claude/skills/flow-init/scripts/consolidate-research.sh +0 -182
  453. package/.claude/skills/flow-init/scripts/create-requirement.sh +0 -404
  454. package/.claude/skills/flow-init/scripts/generate-research-tasks.sh +0 -157
  455. package/.claude/skills/flow-init/scripts/populate-research-tasks.sh +0 -284
  456. package/.claude/skills/flow-init/scripts/validate-research.sh +0 -340
  457. package/.claude/skills/flow-quality/SKILL.md +0 -98
  458. package/.claude/skills/flow-quality/context.jsonl +0 -6
  459. package/.claude/skills/flow-quality/references/code-quality-reviewer.md +0 -205
  460. package/.claude/skills/flow-quality/references/qa-tester.md +0 -313
  461. package/.claude/skills/flow-quality/references/security-reviewer.md +0 -314
  462. package/.claude/skills/flow-quality/references/spec-reviewer.md +0 -221
  463. package/.claude/skills/flow-release/SKILL.md +0 -60
  464. package/.claude/skills/flow-release/context.jsonl +0 -5
  465. package/.claude/skills/flow-release/references/release-manager.md +0 -295
  466. package/.claude/skills/flow-spec/CLAUDE.md +0 -17
  467. package/.claude/skills/flow-spec/SKILL.md +0 -102
  468. package/.claude/skills/flow-spec/context.jsonl +0 -5
  469. package/.claude/skills/flow-spec/scripts/entry-gate.sh +0 -194
  470. package/.claude/skills/flow-spec/scripts/exit-gate.sh +0 -244
  471. package/.claude/skills/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  472. package/.claude/skills/flow-spec/scripts/team-communication.sh +0 -353
  473. package/.claude/skills/flow-spec/scripts/team-init.sh +0 -195
  474. package/.claude/skills/flow-spec/scripts/test-team-mode.sh +0 -496
  475. package/.claude/skills/flow-spec/team-config.json +0 -165
  476. package/.claude/skills/flow-verify/CLAUDE.md +0 -10
  477. package/.claude/skills/flow-verify/SKILL.md +0 -53
  478. package/.claude/skills/flow-verify/context.jsonl +0 -5
  479. package/.claude/skills/fractal-docs/SKILL.md +0 -45
  480. package/.claude/skills/journey-checker/SKILL.md +0 -199
  481. package/.claude/skills/journey-checker/pressure-scenarios.md +0 -164
  482. package/.claude/skills/receiving-review/SKILL.md +0 -153
  483. package/.claude/skills/skill-creator/LICENSE.txt +0 -202
  484. package/.claude/skills/skill-creator/SKILL.md +0 -356
  485. package/.claude/skills/skill-creator/references/output-patterns.md +0 -82
  486. package/.claude/skills/skill-creator/references/workflows.md +0 -28
  487. package/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
  488. package/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
  489. package/.claude/skills/skill-creator/scripts/quick_validate.py +0 -95
  490. package/.claude/skills/skill-rules.json +0 -359
  491. package/.claude/skills/tdd/SKILL.md +0 -218
  492. package/.claude/skills/tdd-enforcer/SKILL.md +0 -192
  493. package/.claude/skills/utility/npm-release/CLAUDE.md +0 -55
  494. package/.claude/skills/utility/npm-release/SKILL.md +0 -379
  495. package/.claude/skills/utility/npm-release/references/version-decision-guide.md +0 -134
  496. package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +0 -95
  497. package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +0 -82
  498. package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +0 -44
  499. package/.claude/skills/verification/SKILL.md +0 -158
  500. package/.claude/skills/workflow.yaml +0 -219
  501. package/.claude/tests/README.md +0 -300
  502. package/.claude/tests/TODO.md +0 -69
  503. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  504. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  505. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  506. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  507. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  508. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  509. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  510. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  511. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  512. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  513. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  514. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  515. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  516. package/.claude/tests/run-all-tests.sh +0 -229
  517. package/.claude/tests/scripts/run.sh +0 -30
  518. package/.claude/tests/scripts/test-framework.sh +0 -128
  519. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  520. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  521. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  522. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  523. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  524. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  525. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  526. package/.claude/tests/scripts/test_common.sh +0 -244
  527. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  528. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  529. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  530. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  531. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  532. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  533. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  534. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  535. package/.claude/tests/slugify.bats +0 -82
  536. package/.claude/tests/test-framework.sh +0 -732
  537. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  538. package/.claude/tests/test_consolidate_research.py +0 -48
  539. package/.claude/tests/test_export_contracts.py +0 -43
  540. package/.claude/tests/test_extract_data_model.py +0 -33
  541. package/.claude/tests/test_generate_quickstart.py +0 -50
  542. package/.claude/tests/test_generate_research_tasks.py +0 -52
  543. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +0 -1
  544. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +0 -2
  545. package/bin/harness.js +0 -22
  546. package/docs/commands/core-roadmap.md +0 -106
  547. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  548. package/docs/commands/core-style.md +0 -53
  549. package/docs/commands/core-style.zh-CN.md +0 -53
  550. package/docs/commands/flow-init.md +0 -140
  551. package/docs/commands/flow-init.zh-CN.md +0 -169
  552. package/docs/commands/flow-new.md +0 -39
  553. package/docs/commands/flow-new.zh-CN.md +0 -39
  554. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  555. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  556. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  557. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  558. package/lib/compiler/context-expander.js +0 -179
  559. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  560. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  561. package/lib/compiler/skill-discovery.js +0 -68
  562. package/lib/harness/CLAUDE.md +0 -22
  563. package/lib/harness/__tests__/planner.tdd.test.js +0 -125
  564. package/lib/harness/cli.js +0 -208
  565. package/lib/harness/index.js +0 -18
  566. package/lib/harness/operations/dispatch.js +0 -298
  567. package/lib/harness/operations/init.js +0 -48
  568. package/lib/harness/operations/pack.js +0 -100
  569. package/lib/harness/operations/plan.js +0 -83
  570. package/lib/harness/operations/release.js +0 -170
  571. package/lib/harness/operations/resume.js +0 -44
  572. package/lib/harness/operations/verify.js +0 -177
  573. package/lib/harness/planner.js +0 -272
  574. package/lib/harness/query.js +0 -126
  575. package/lib/harness/schemas.js +0 -129
package/.claude/commands/util/cancel-ralph.md DELETED
@@ -1,60 +0,0 @@
1
- ---
2
- name: "cancel-ralph"
3
- description: "Cancel active Ralph Wiggum loop"
4
- allowed-tools: ["Bash(test -f .claude/ralph-loop.local.md:*)", "Bash(rm .claude/ralph-loop.local.md)", "Read(.claude/ralph-loop.local.md)"]
5
- hide-from-slash-command-tool: "true"
6
- ---
7
-
8
- # Cancel Ralph - 取消 Ralph 循环
9
-
10
- ## 用途
11
-
12
- 手动取消当前会话中正在运行的 Ralph 循环。
13
-
14
- ## 使用方法
15
-
16
- ```
17
- /cancel-ralph
18
- ```
19
-
20
- ## 执行步骤
21
-
22
- 1. 检查 `.claude/ralph-loop.local.md` 是否存在
23
- ```bash
24
- test -f .claude/ralph-loop.local.md && echo "EXISTS" || echo "NOT_FOUND"
25
- ```
26
-
27
- 2. **如果 NOT_FOUND**:
28
- - 输出: "No active Ralph loop found."
29
-
30
- 3. **如果 EXISTS**:
31
- - 读取 `.claude/ralph-loop.local.md` 获取当前 iteration
32
- - 删除状态文件:
33
- ```bash
34
- rm .claude/ralph-loop.local.md
35
- ```
36
- - 输出: "Cancelled Ralph loop (was at iteration N)" 其中 N 是 iteration 值
37
-
38
- ## 何时使用
39
-
40
- - Ralph 循环陷入死循环
41
- - 需要手动干预修复问题
42
- - 想要停止无限循环
43
-
44
- ## 示例
45
-
46
- ```
47
- User: /cancel-ralph
48
- Assistant: [检查状态文件]
49
- Assistant: Cancelled Ralph loop (was at iteration 15)
50
- ```
51
-
52
- ## 注意事项
53
-
54
- - 取消后需要手动清理未完成的工作
55
- - 建议在取消前检查 ERROR_LOG.md 了解问题
56
- - 可以重新运行 `/flow-ralph` 从当前状态继续
57
-
58
- ---
59
-
60
- **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
package/.claude/commands/util/code-review.md DELETED
@@ -1,58 +0,0 @@
1
- ---
2
- name: code-review-high
3
- description: 'Produce a high-rigor code review report with severity triage. Usage: /code-review-high "<diff or summary>"'
4
- scripts:
5
- review: .claude/scripts/run-high-review.sh
6
- ---
7
-
8
- # Code-Review-High - 高强度代码审查命令
9
-
10
- ## User Input
11
- ```text
12
- $ARGUMENTS = "<patch|summary|PR URL>"
13
- ```
14
- 可传递 git diff、文件路径列表或变更摘要。命令会把输入交给后端脚本执行标准化审查流程。
15
-
16
- ## 执行流程
17
-
18
- ### 阶段 1: 输入收集
19
- - 接受变更摘要（本地 diff、PR 链接、文件列表）。
20
- - 解析模块范围、涉及文件数量、风险等级。
21
-
22
- ### 阶段 2: 调用审查脚本
23
- ```
24
- Run: {SCRIPT:review} --input "<payload>" --severity high
25
- ```
26
- - 脚本加载审查模板 (.claude/docs/templates/REVIEW-HIGH.md)。
27
- - 聚合上下文：最近提交、相关测试结果、配置/基础设施变更。
28
-
29
- ### 阶段 3: 生成报告
30
- - 输出结构遵循高强度审查骨架：
31
- - Summary、Top risks、Approval 建议
32
- - 受影响文件列表
33
- - Root cause & assumptions
34
- - Findings（按严重度分类，附位置与修复建议）
35
- - Performance、Integration、Testing、Docs、Open questions、Final recommendation
36
- - 报告保存为 `reviews/high-review-${timestamp}.md`，并打印路径。
37
-
38
- ## 审查准则
39
- - 关注 correctness、security、performance、integration、test 覆盖、长期可维护性。
40
- - 使用提供的 severity rubric（BLOCKER/HIGH/MEDIUM/LOW/NIT）。
41
- - 每个高风险问题需给出最小修复方案与验证方式。
42
- - 若缺少必要上下文（测试计划、迁移脚本等），在 Findings 中标注并请求补充。
43
-
44
- ## 错误处理
45
- - 输入为空 → 提示提供 diff 或摘要。
46
- - 脚本运行失败 → 输出错误日志路径。
47
- - 报告写入失败 → 保留临时文件并提示手动保存。
48
-
49
- ## 输出
50
- ```
51
- ✅ reviews/high-review-*.md
52
- ✅ 控制台显示摘要和建议
53
- ```
54
-
55
- ## 下一步
56
- - 将报告附在 PR 审查意见中。
57
- - 若存在 BLOCKER/HIGH 问题，要求作者修复后再次运行本命令。
58
- - Reviewed PR 通过后，可存档报告于 devflow/requirements/${REQ}/reviews/。
package/.claude/commands/util/git-commit.md DELETED
@@ -1,422 +0,0 @@
1
- ---
2
- name: git-commit
3
- description: Git Commit 工作流最佳实践 - Conventional Commits 规范、分支策略、PR 管理
4
- version: 3.0.0
5
- author: CC-DevFlow
6
- updated_at: 2026-01-04
7
- ---
8
-
9
- > **哲学核心**：Commit 是代码历史的节点，每个节点都应该清晰、独立、可追溯。
10
- > **Rebase 信仰**：优先使用 `git rebase` 保持线性历史，让提交历史像链表一样优雅。
11
- > **协作原则**：本地项目直接合并，远程项目走 PR 流程，代码审查是质量保障的自然环节。
12
-
13
- ---
14
-
15
- ## 📋 Commit Message 规范
16
-
17
- ### 格式标准（Conventional Commits）
18
-
19
- ```
20
- <type>(<scope>): <subject>
21
-
22
- <body>
23
-
24
- <footer>
25
- ```
26
-
27
- ### Type 类型
28
-
29
- | Type | 说明 | 示例 |
30
- |------|------|------|
31
- | `feat` | 新功能 | `feat(user): 添加登录功能` |
32
- | `fix` | 修复 Bug | `fix(auth): 修复 token 过期问题` |
33
- | `docs` | 文档更新 | `docs(readme): 更新安装说明` |
34
- | `style` | 代码格式 | `style(utils): 统一代码缩进` |
35
- | `refactor` | 重构 | `refactor(api): 简化请求处理逻辑` |
36
- | `perf` | 性能优化 | `perf(render): 优化列表渲染性能` |
37
- | `test` | 测试 | `test(utils): 添加工具函数单元测试` |
38
- | `chore` | 构建/工具 | `chore(deps): 更新依赖版本` |
39
-
40
- ### 编写规则
41
-
42
- - **Subject**：50 字以内，祈使句，首字母小写，结尾不加句号
43
- - **Body**：72 字换行，说明为什么和如何，而非做了什么
44
- - **Footer**：`BREAKING CHANGE: <描述>` 或 `Closes #123`
45
-
46
- ### ✅ 好示例
47
-
48
- ```
49
- feat(user): 添加微信登录功能
50
-
51
- 支持通过微信授权码快速登录，提升用户体验。
52
- 登录成功后自动同步用户信息到本地存储。
53
-
54
- Closes #123
55
- ```
56
-
57
- ---
58
-
59
- ## 🔄 工作流程
60
-
61
- ### 远程项目 PR 流程（团队协作）
62
-
63
- ```bash
64
- # 1. 创建功能分支
65
- git checkout main
66
- git pull --rebase
67
- git checkout -b feature/my-feature
68
-
69
- # 2. 开发并提交（多次小提交）
70
- git add <file1>
71
- git commit -m "feat(module): 实现核心功能"
72
- git add <file2>
73
- git commit -m "test(module): 添加单元测试"
74
-
75
- # 3. 推送前 rebase 主分支（保持线性历史）
76
- git checkout main
77
- git pull --rebase
78
- git checkout feature/my-feature
79
- git rebase main
80
-
81
- # 4. 推送到远程
82
- git push -u origin feature/my-feature
83
- # rebase 后需要 force push
84
- git push --force-with-lease
85
-
86
- # 5. 创建 Pull Request
87
- gh pr create --title "feat: 添加新功能" --body "$(cat <<'EOF'
88
- ## Summary
89
- - 实现核心功能模块
90
- - 添加完整测试覆盖
91
-
92
- ## Test plan
93
- - [x] 单元测试通过
94
- - [x] 集成测试通过
95
-
96
- 🤖 Generated with [Claude Code](https://claude.com/claude-code)
97
- EOF
98
- )"
99
-
100
- # 6. 合并 PR 后清理
101
- git checkout main
102
- git pull --rebase
103
- git branch -d feature/my-feature
104
- ```
105
-
106
- ---
107
-
108
- ### 本地项目直接合并（个人项目）
109
-
110
- ```bash
111
- # 1. 创建功能分支
112
- git checkout main
113
- git checkout -b feature/my-feature
114
-
115
- # 2. 开发并提交
116
- git add .
117
- git commit -m "feat(module): 实现核心功能"
118
-
119
- # 3. Rebase 主分支并快进合并
120
- git checkout main
121
- git pull --rebase # 如果有远程仓库
122
- git checkout feature/my-feature
123
- git rebase main
124
- git checkout main
125
- git merge --ff-only feature/my-feature
126
-
127
- # 4. 清理分支
128
- git branch -d feature/my-feature
129
- ```
130
-
131
- ---
132
-
133
- ### 🚨 紧急修复流程（Hotfix）
134
-
135
- ```bash
136
- # 1. 从 main 创建热修复分支
137
- git checkout main
138
- git pull --rebase
139
- git checkout -b hotfix/critical-issue
140
-
141
- # 2. 修复并提交
142
- git add .
143
- git commit -m "fix(critical): 修复紧急问题"
144
-
145
- # 3. 合并到 main 和 develop
146
- git checkout main
147
- git merge hotfix/critical-issue
148
- git push
149
-
150
- git checkout develop
151
- git merge hotfix/critical-issue
152
- git push
153
-
154
- # 4. 清理分支
155
- git branch -d hotfix/critical-issue
156
- ```
157
-
158
- ---
159
-
160
- ## 📦 多文件拆分提交工作流（NEW）
161
-
162
- > **原则**：涉及多文件时，必须按同类变更拆分提交，每个 commit 只包含一类变更。
163
-
164
- ### 场景 1：功能 + 测试 + 文档
165
-
166
- ```bash
167
- # ❌ 错误：一次性提交所有文件
168
- git add .
169
- git commit -m "feat: 添加用户管理功能"
170
-
171
- # ✅ 正确：按类型拆分提交
172
- # 第一次提交：核心功能实现
173
- git add src/services/user.ts src/routes/user.ts
174
- git commit -m "feat(user): 实现用户管理核心功能"
175
-
176
- # 第二次提交：测试文件
177
- git add tests/user.test.ts
178
- git commit -m "test(user): 添加用户管理单元测试"
179
-
180
- # 第三次提交：文档更新
181
- git add docs/api/user.md README.md
182
- git commit -m "docs(user): 添加用户管理 API 文档"
183
-
184
- # 第四次提交：配置变更
185
- git add .env.example config/user.yml
186
- git commit -m "chore(user): 添加用户管理配置文件"
187
- ```
188
-
189
- ### 场景 2：重构多个模块
190
-
191
- ```bash
192
- # ✅ 按模块拆分提交
193
- # 第一次提交：auth 模块重构
194
- git add src/services/auth.ts src/middlewares/auth.ts
195
- git commit -m "refactor(auth): 简化认证逻辑"
196
-
197
- # 第二次提交：user 模块重构
198
- git add src/services/user.ts src/models/user.ts
199
- git commit -m "refactor(user): 优化用户服务层"
200
-
201
- # 第三次提交：api 模块重构
202
- git add src/routes/api.ts src/controllers/api.ts
203
- git commit -m "refactor(api): 统一 API 错误处理"
204
- ```
205
-
206
- ### 场景 3：跨层修改（数据库 + 服务 + API）
207
-
208
- ```bash
209
- # ✅ 按层次拆分提交
210
- # 第一次提交：数据模型层
211
- git add prisma/schema.prisma prisma/migrations/*
212
- git commit -m "feat(db): 添加 order 表及关联字段"
213
-
214
- # 第二次提交：服务层
215
- git add src/services/order.ts src/lib/prisma/order.ts
216
- git commit -m "feat(order): 实现订单服务逻辑"
217
-
218
- # 第三次提交：API 路由层
219
- git add src/routes/order.ts src/controllers/order.ts
220
- git commit -m "feat(order): 添加订单 API 接口"
221
-
222
- # 第四次提交：前端集成
223
- git add miniprogram/pages/order/* miniprogram/utils/order-api.js
224
- git commit -m "feat(order): 小程序订单页面集成"
225
- ```
226
-
227
- ### 场景 4：Bug 修复 + 防御性代码
228
-
229
- ```bash
230
- # ✅ 先修复 bug，再添加防御
231
- # 第一次提交：核心 bug 修复
232
- git add src/services/payment.ts
233
- git commit -m "fix(payment): 修复支付回调处理逻辑"
234
-
235
- # 第二次提交：添加测试
236
- git add tests/payment.test.ts
237
- git commit -m "test(payment): 添加支付回调场景测试"
238
-
239
- # 第三次提交：防御性代码
240
- git add src/middlewares/validator.ts
241
- git commit -m "feat(payment): 添加支付参数校验中间件"
242
- ```
243
-
244
- ### 拆分提交的技巧
245
-
246
- ```bash
247
- # 技巧 1：交互式添加（部分文件添加）
248
- git add -p <file> # 逐块选择要提交的代码
249
-
250
- # 技巧 2：查看未提交变更
251
- git status -s
252
- git diff --stat
253
-
254
- # 技巧 3：临时保存其他变更
255
- git stash push -m "临时保存其他模块变更" -- <files>
256
-
257
- # 技巧 4：整理已提交历史
258
- git rebase -i HEAD~5 # 交互式整理最近 5 个 commit
259
- ```
260
-
261
- ### 拆分原则
262
-
263
- | 维度 | 拆分规则 | 示例 |
264
- |------|----------|------|
265
- | **功能维度** | 实现 → 测试 → 文档 | `feat → test → docs` |
266
- | **模块维度** | 按模块边界拆分 | `auth → user → order` |
267
- | **层次维度** | 按架构分层拆分 | `model → service → route → UI` |
268
- | **类型维度** | 按文件类型拆分 | `.ts → .test.ts → .md → .yml` |
269
- | **影响范围** | 核心 → 边缘 | `核心逻辑 → 配置 → 文档` |
270
-
271
- ---
272
-
273
- ## 🔄 Rebase 最佳实践
274
-
275
- ### 日常 Rebase
276
-
277
- ```bash
278
- # 功能分支定期 rebase 主分支
279
- git checkout feature/my-feature
280
- git fetch origin
281
- git rebase origin/main
282
-
283
- # 解决冲突后继续
284
- git add .
285
- git rebase --continue
286
-
287
- # 中止 rebase
288
- git rebase --abort
289
- ```
290
-
291
- ### 交互式 Rebase 整理历史
292
-
293
- ```bash
294
- # 整理最近 3 个 commit
295
- git rebase -i HEAD~3
296
-
297
- # 操作选项：
298
- # pick: 保留 commit
299
- # reword: 修改 message
300
- # squash: 合并到上一个 commit（保留 message）
301
- # fixup: 合并到上一个 commit（丢弃 message）
302
- # drop: 删除 commit
303
- ```
304
-
305
- ### Rebase 黄金法则
306
-
307
- ```yaml
308
- 核心原则: "永远不要 rebase 公共分支的历史"
309
-
310
- ✅ 安全场景：
311
- - 个人功能分支 rebase 主分支
312
- - 本地未推送的提交整理
313
-
314
- ❌ 危险场景：
315
- - 主分支（main/master/develop）
316
- - 多人协作的长期分支
317
- - 已推送到公共仓库的提交
318
- ```
319
-
320
- ### Force Push 安全使用
321
-
322
- ```bash
323
- # ❌ 危险：无脑覆盖
324
- git push --force
325
-
326
- # ✅ 安全：仅当远程无新提交时才覆盖
327
- git push --force-with-lease
328
- ```
329
-
330
- ---
331
-
332
- ## 📤 Pull Request 管理
333
-
334
- ### 创建 PR
335
-
336
- ```bash
337
- # 使用 gh 命令创建 PR
338
- gh pr create \
339
- --title "feat(module): 添加新功能" \
340
- --body "$(cat <<'EOF'
341
- ## Summary
342
- - 实现了 XXX 核心功能
343
- - 添加了完整的测试覆盖
344
-
345
- ## Test Plan
346
- - [x] 单元测试通过
347
- - [x] 集成测试通过
348
-
349
- ## Related Issues
350
- Closes #123
351
-
352
- 🤖 Generated with [Claude Code](https://claude.com/claude-code)
353
- EOF
354
- )"
355
- ```
356
-
357
- ### PR 合并策略
358
-
359
- ```bash
360
- # 1. Squash merge（推荐，合并为单个 commit）
361
- gh pr merge 123 --squash --delete-branch
362
-
363
- # 2. Rebase merge（线性历史）
364
- gh pr merge 123 --rebase --delete-branch
365
-
366
- # 3. Merge commit（保留完整历史）
367
- gh pr merge 123 --merge
368
- ```
369
-
370
- ### PR 最佳实践
371
-
372
- - ✅ 每个 PR ≤ 400 行代码变更
373
- - ✅ 专注单一功能或修复
374
- - ✅ 推送前 `git rebase main`
375
- - ✅ 所有讨论解决后再合并
376
-
377
- ---
378
-
379
- ## 🛠️ 常用命令速查
380
-
381
- ```bash
382
- # 查看状态
383
- git status -s
384
- git diff --staged
385
-
386
- # 提交
387
- git add -p # 交互式添加
388
- git commit -m "message" # 快速提交
389
- git commit --amend # 修改最后一次提交
390
-
391
- # 撤销
392
- git restore <file> # 撤销工作区变更
393
- git restore --staged <file> # 撤销暂存区变更
394
- git reset --soft HEAD~1 # 撤销提交（保留变更）
395
-
396
- # 分支
397
- git switch -c <branch> # 创建并切换分支
398
- git branch -d <branch> # 删除分支
399
-
400
- # 暂存
401
- git stash push -m "desc" -- <files>
402
- git stash pop
403
-
404
- # 历史
405
- git log --oneline --graph
406
- git show <commit-hash>
407
- ```
408
-
409
- ---
410
-
411
- ## 🎯 核心原则
412
-
413
- 1. **原子性提交**：每个 commit 只做一件事，功能完整、可独立测试
414
- 2. **清晰的 Message**：遵循 Conventional Commits，让历史可读可追溯
415
- 3. **频繁提交**：小步快跑，不积累大量变更
416
- 4. **保持线性历史**：优先 rebase，让历史像链表一样优雅
417
- 5. **同类变更分组**：多文件按类型/模块/层次拆分提交
418
- 6. **安全的 Force Push**：仅在个人分支使用 `--force-with-lease`
419
-
420
- ---
421
-
422
- **记住**：好的 commit 历史是项目最好的文档。代码是写给人看的，只是顺便让机器运行。
package/.claude/commands/util/problem-analyzer.md DELETED
@@ -1,60 +0,0 @@
1
- ---
2
- name: problem-analyzer
3
- description: 'Diagnose incidents or regressions and outline minimal fixes. Usage: /problem-analyzer "<issue description>"'
4
- scripts:
5
- analyze: .claude/scripts/run-problem-analysis.sh
6
- ---
7
-
8
- # Problem-Analyzer - 问题诊断命令
9
-
10
- ## User Input
11
- ```text
12
- $ARGUMENTS = "<bug report | stack trace | failing test output>"
13
- ```
14
- 请提供问题现象、日志片段、相关模块等信息。若多个症状可使用多行或 Markdown 列表。
15
-
16
- ## 执行流程
17
-
18
- ### 阶段 1: 资料收集
19
- - 解析输入中的组件名称、报错关键字、最近提交 ID。
20
- - 自动查找与关键词匹配的文件（src/, tests/, migrations/ 等）供快速定位。
21
-
22
- ### 阶段 2: 调用分析脚本
23
- ```
24
- Run: {SCRIPT:analyze} --input "<payload>"
25
- ```
26
- - 脚本聚合：
27
- - git 历史：与问题模块相关的最近提交
28
- - 日志/栈信息（如提供）
29
- - 测试结果（若输入包含 failing tests）
30
- - 生成诊断草稿 (tmp/problem-analysis-*.json) 供审查。
31
-
32
- ### 阶段 3: 结构化输出
33
- - 自动套用标准模板，输出：
34
- - Affected files (路径 + 原因)
35
- - Root cause （短说明 + 传播路径）
36
- - Proposed fix（最小修复、阶段步骤、测试清单）
37
- - Documentation gaps（需更新的 README/ADR/config/schema）
38
- - Open questions / assumptions
39
- - 报告写入 `analysis/problem-${timestamp}.md` 并回显路径。
40
-
41
- ## 诊断准则
42
- - 优先定位“一因多果”的根因；避免泛泛记录症状。
43
- - 修复建议需可落地：列出主要代码块/函数及测试更新。
44
- - 未知假设需明确列出并在 Open questions 中提醒跟进。
45
-
46
- ## 错误处理
47
- - 输入不足 → 提示提供最少信息（现象 + 模块或错误消息）。
48
- - 自动定位失败 → 输出“人工筛查建议”并生成空模板。
49
- - 报告写入失败 → 保留临时 JSON 供手动导出。
50
-
51
- ## 输出
52
- ```
53
- ✅ analysis/problem-*.md
54
- ✅ 控制台显示根因摘要与建议修复
55
- ```
56
-
57
- ## 下一步
58
- - 将报告附于 bug ticket 或 PR 描述。
59
- - 根据 Proposed fix 执行修复，并在 `/flow-fix` 中引用该报告。
60
- - 诊断完成后，更新 README/ADR/运行手册中相关章节。