cc-devflow 4.1.6 → 4.3.0

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 (128) hide show
  1. package/.claude/commands/core/architecture.md +30 -0
  2. package/.claude/commands/core/guidelines.md +25 -0
  3. package/.claude/commands/core/roadmap.md +29 -0
  4. package/.claude/commands/core/style.md +18 -0
  5. package/.claude/commands/flow/CLAUDE.md +0 -4
  6. package/.claude/docs/examples/design-inspiration-pool.md +59 -0
  7. package/.claude/docs/examples/ui-prototype-constitution-checklist.md +75 -0
  8. package/.claude/docs/implementation-summary-v7.md +449 -0
  9. package/.claude/docs/spec-format-guide.md +349 -0
  10. package/.claude/docs/state-consolidation-design.md +323 -0
  11. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +85 -386
  12. package/.claude/docs/templates/DESIGN_TEMPLATE.md +157 -0
  13. package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +91 -0
  14. package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +139 -0
  15. package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +93 -0
  16. package/.claude/docs/templates/STYLE_TEMPLATE.md +114 -901
  17. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +143 -1205
  18. package/.claude/hooks/inject-agent-context.ts +9 -9
  19. package/.claude/scripts/.claude/commands/flow/export-openspec.md +221 -0
  20. package/.claude/scripts/.claude/commands/flow/import-openspec.md +171 -0
  21. package/.claude/scripts/__tests__/openspec.test.js +212 -0
  22. package/.claude/scripts/delta-parser.ts +112 -2
  23. package/.claude/scripts/export-openspec.js +222 -0
  24. package/.claude/scripts/import-openspec.js +272 -0
  25. package/.claude/scripts/validate-scope.sh +200 -0
  26. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +25 -0
  27. package/.claude/skills/flow-dev/SKILL.md +94 -0
  28. package/.claude/skills/flow-init/SKILL.md +105 -0
  29. package/.claude/skills/{workflow/flow-release → flow-release}/SKILL.md +14 -3
  30. package/.claude/skills/flow-spec/SKILL.md +102 -0
  31. package/.claude/skills/utility/npm-release/CLAUDE.md +55 -0
  32. package/.claude/skills/utility/npm-release/SKILL.md +111 -46
  33. package/.claude/skills/utility/npm-release/references/version-decision-guide.md +134 -0
  34. package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +95 -0
  35. package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +82 -0
  36. package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +44 -0
  37. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +1 -0
  38. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +2 -0
  39. package/CHANGELOG.md +81 -0
  40. package/README.md +7 -1
  41. package/README.zh-CN.md +7 -1
  42. package/bin/cc-devflow-cli.js +154 -0
  43. package/docs/v4.3.0-migration-guide.md +276 -0
  44. package/lib/harness/CLAUDE.md +5 -4
  45. package/lib/harness/__tests__/planner.tdd.test.js +125 -0
  46. package/lib/harness/index.js +4 -2
  47. package/lib/harness/operations/dispatch.js +13 -0
  48. package/lib/harness/operations/plan.js +55 -1
  49. package/lib/harness/operations/release.js +87 -0
  50. package/lib/harness/operations/verify.js +14 -0
  51. package/lib/harness/planner.js +131 -0
  52. package/lib/harness/query.js +126 -0
  53. package/lib/harness/schemas.js +22 -1
  54. package/package.json +1 -1
  55. package/.claude/commands/flow/checklist.md +0 -18
  56. package/.claude/commands/flow/clarify.md +0 -18
  57. package/.claude/commands/flow/new.md +0 -23
  58. package/.claude/commands/flow/quality.md +0 -21
  59. package/.claude/docs/templates/EPIC_TEMPLATE.md +0 -805
  60. package/.claude/docs/templates/PRD_TEMPLATE.md +0 -562
  61. package/.claude/docs/templates/TASKS_TEMPLATE.md +0 -523
  62. package/.claude/docs/templates/TECH_DESIGN_TEMPLATE.md +0 -1019
  63. package/.claude/skills/workflow/CLAUDE.md +0 -24
  64. package/.claude/skills/workflow/flow-dev/SKILL.md +0 -58
  65. package/.claude/skills/workflow/flow-init/SKILL.md +0 -55
  66. package/.claude/skills/workflow/flow-spec/SKILL.md +0 -42
  67. /package/.claude/skills/{domain/attention-refresh → attention-refresh}/SKILL.md +0 -0
  68. /package/.claude/skills/{domain/brainstorming → brainstorming}/SKILL.md +0 -0
  69. /package/.claude/skills/{guardrail/constitution-guardian → constitution-guardian}/SKILL.md +0 -0
  70. /package/.claude/skills/{utility/constitution-quick-ref → constitution-quick-ref}/SKILL.md +0 -0
  71. /package/.claude/skills/{domain/debugging → debugging}/SKILL.md +0 -0
  72. /package/.claude/skills/{utility/file-standards → file-standards}/SKILL.md +0 -0
  73. /package/.claude/skills/{domain/finishing-branch → finishing-branch}/SKILL.md +0 -0
  74. /package/.claude/skills/{workflow/flow-dev → flow-dev}/CLAUDE.md +0 -0
  75. /package/.claude/skills/{workflow/flow-dev → flow-dev}/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -0
  76. /package/.claude/skills/{workflow/flow-dev → flow-dev}/context.jsonl +0 -0
  77. /package/.claude/skills/{workflow/flow-dev → flow-dev}/dev-implementer.jsonl +0 -0
  78. /package/.claude/skills/{workflow/flow-dev → flow-dev}/scripts/entry-gate.sh +0 -0
  79. /package/.claude/skills/{workflow/flow-dev → flow-dev}/scripts/exit-gate.sh +0 -0
  80. /package/.claude/skills/{workflow/flow-dev → flow-dev}/scripts/task-orchestrator.sh +0 -0
  81. /package/.claude/skills/{workflow/flow-fix → flow-fix}/SKILL.md +0 -0
  82. /package/.claude/skills/{workflow/flow-fix → flow-fix}/context.jsonl +0 -0
  83. /package/.claude/skills/{workflow/flow-fix → flow-fix}/references/bug-analyzer.md +0 -0
  84. /package/.claude/skills/{workflow/flow-init → flow-init}/assets/BRAINSTORM_TEMPLATE.md +0 -0
  85. /package/.claude/skills/{workflow/flow-init → flow-init}/assets/INIT_FLOW_TEMPLATE.md +0 -0
  86. /package/.claude/skills/{workflow/flow-init → flow-init}/assets/RESEARCH_TEMPLATE.md +0 -0
  87. /package/.claude/skills/{workflow/flow-init → flow-init}/context.jsonl +0 -0
  88. /package/.claude/skills/{workflow/flow-init → flow-init}/references/flow-researcher.md +0 -0
  89. /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/check-prerequisites.sh +0 -0
  90. /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/consolidate-research.sh +0 -0
  91. /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/create-requirement.sh +0 -0
  92. /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/generate-research-tasks.sh +0 -0
  93. /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/populate-research-tasks.sh +0 -0
  94. /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/validate-research.sh +0 -0
  95. /package/.claude/skills/{workflow/flow-quality → flow-quality}/SKILL.md +0 -0
  96. /package/.claude/skills/{workflow/flow-quality → flow-quality}/context.jsonl +0 -0
  97. /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/code-quality-reviewer.md +0 -0
  98. /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/qa-tester.md +0 -0
  99. /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/security-reviewer.md +0 -0
  100. /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/spec-reviewer.md +0 -0
  101. /package/.claude/skills/{workflow/flow-release → flow-release}/context.jsonl +0 -0
  102. /package/.claude/skills/{workflow/flow-release → flow-release}/references/release-manager.md +0 -0
  103. /package/.claude/skills/{workflow/flow-spec → flow-spec}/CLAUDE.md +0 -0
  104. /package/.claude/skills/{workflow/flow-spec → flow-spec}/context.jsonl +0 -0
  105. /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/entry-gate.sh +0 -0
  106. /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/exit-gate.sh +0 -0
  107. /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/parallel-orchestrator.sh +0 -0
  108. /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/team-communication.sh +0 -0
  109. /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/team-init.sh +0 -0
  110. /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/test-team-mode.sh +0 -0
  111. /package/.claude/skills/{workflow/flow-spec → flow-spec}/team-config.json +0 -0
  112. /package/.claude/skills/{workflow/flow-verify → flow-verify}/CLAUDE.md +0 -0
  113. /package/.claude/skills/{workflow/flow-verify → flow-verify}/SKILL.md +0 -0
  114. /package/.claude/skills/{workflow/flow-verify → flow-verify}/context.jsonl +0 -0
  115. /package/.claude/skills/{utility/fractal-docs → fractal-docs}/SKILL.md +0 -0
  116. /package/.claude/skills/{utility/journey-checker → journey-checker}/SKILL.md +0 -0
  117. /package/.claude/skills/{utility/journey-checker → journey-checker}/pressure-scenarios.md +0 -0
  118. /package/.claude/skills/{domain/receiving-review → receiving-review}/SKILL.md +0 -0
  119. /package/.claude/skills/{utility/skill-creator → skill-creator}/LICENSE.txt +0 -0
  120. /package/.claude/skills/{utility/skill-creator → skill-creator}/SKILL.md +0 -0
  121. /package/.claude/skills/{utility/skill-creator → skill-creator}/references/output-patterns.md +0 -0
  122. /package/.claude/skills/{utility/skill-creator → skill-creator}/references/workflows.md +0 -0
  123. /package/.claude/skills/{utility/skill-creator → skill-creator}/scripts/init_skill.py +0 -0
  124. /package/.claude/skills/{utility/skill-creator → skill-creator}/scripts/package_skill.py +0 -0
  125. /package/.claude/skills/{utility/skill-creator → skill-creator}/scripts/quick_validate.py +0 -0
  126. /package/.claude/skills/{domain/tdd → tdd}/SKILL.md +0 -0
  127. /package/.claude/skills/{guardrail/tdd-enforcer → tdd-enforcer}/SKILL.md +0 -0
  128. /package/.claude/skills/{domain/verification → verification}/SKILL.md +0 -0
@@ -1,24 +0,0 @@
1
- # workflow/
2
- > L2 | 父级: /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/.claude/CLAUDE.md
3
-
4
- 成员清单
5
- flow-init/SKILL.md: 需求初始化入口,调用 harness:init + harness:pack。
6
- flow-init/context.jsonl: flow-init 的上下文注入定义。
7
- flow-spec/SKILL.md: 计划生成入口,调用 harness:plan 产出 task-manifest。
8
- flow-spec/context.jsonl: flow-spec 的上下文注入定义。
9
- flow-spec/team-config.json: 旧 Team 配置资产(兼容保留,当前主链不依赖)。
10
- flow-dev/SKILL.md: 执行入口,调用 harness:dispatch/resume 并写 checkpoint/events。
11
- flow-dev/context.jsonl: flow-dev 的上下文注入定义。
12
- flow-dev/dev-implementer.jsonl: 旧 dev-implementer 上下文(兼容保留)。
13
- flow-verify/SKILL.md: 质量门禁入口,调用 harness:verify 输出 report-card。
14
- flow-verify/context.jsonl: flow-verify 的上下文注入定义。
15
- flow-release/SKILL.md: 发布入口,调用 harness:release + harness:janitor。
16
- flow-release/context.jsonl: flow-release 的上下文注入定义。
17
- flow-quality/SKILL.md: 旧质量流程技能(迁移过渡保留)。
18
- flow-quality/context.jsonl: 旧质量流程上下文(迁移过渡保留)。
19
- flow-fix/SKILL.md: Bug 修复流程技能。
20
- flow-fix/context.jsonl: flow-fix 的上下文注入定义。
21
-
22
- 法则: 成员完整·一行一文件·父级链接·技术词前置
23
-
24
- [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
@@ -1,58 +0,0 @@
1
- ---
2
- name: flow-dev
3
- description: 'Execute task-manifest with dependency-aware parallel dispatch and checkpoint recovery. Use when implementing planned tasks for a requirement.'
4
- ---
5
-
6
- # Flow-Dev Skill
7
-
8
- > [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
9
-
10
- ## Purpose
11
-
12
- 执行 `task-manifest.json` 中的任务,默认并行调度并写入 checkpoint/events 供恢复。
13
-
14
- ## Input Format
15
-
16
- ```bash
17
- /flow:dev "REQ_ID" [--parallel N] [--resume] [--max-retries N]
18
- ```
19
-
20
- ## Execution Steps
21
-
22
- 1. 解析参数:
23
- - 默认 `parallel = 3`
24
- - 默认不 resume
25
- 2. 分支执行:
26
- - 普通执行:
27
-
28
- ```bash
29
- npm run harness:dispatch -- --change-id "${REQ_ID}" --parallel ${PARALLEL} [--max-retries ${MAX_RETRIES}]
30
- ```
31
-
32
- - 恢复执行:
33
-
34
- ```bash
35
- npm run harness:resume -- --change-id "${REQ_ID}" --parallel ${PARALLEL} [--max-retries ${MAX_RETRIES}]
36
- ```
37
-
38
- 3. 检查执行结果:
39
- - `task-manifest.json` 状态更新
40
- - `.harness/runtime/${REQ_ID}/<TASK_ID>/events.jsonl`
41
- - `.harness/runtime/${REQ_ID}/<TASK_ID>/checkpoint.json`
42
-
43
- ## Exit Criteria
44
-
45
- - 所有任务状态为 `passed` 或 `skipped`
46
- - 没有 `running` 残留状态
47
-
48
- ## Failure Handling
49
-
50
- - 若存在 `failed` 任务:
51
- 1. 修复失败原因
52
- 2. 重新运行 `--resume`
53
-
54
- ## Next Step
55
-
56
- ```bash
57
- /flow:verify "${REQ_ID}"
58
- ```
@@ -1,55 +0,0 @@
1
- ---
2
- name: flow-init
3
- description: 'Initialize a requirement with harness state and context package. Use when starting a new REQ/BUG and preparing deterministic execution context for the next stages.'
4
- ---
5
-
6
- # Flow-Init Skill
7
-
8
- > [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
9
-
10
- ## Purpose
11
-
12
- 初始化需求目录的 harness 运行状态,并生成可执行上下文包。
13
-
14
- ## Input Format
15
-
16
- ```bash
17
- /flow:init "REQ_ID|TITLE|PLAN_URLS?"
18
- ```
19
-
20
- - `REQ_ID`: `REQ-123` 或 `BUG-123`
21
- - `TITLE`: 需求标题
22
- - `PLAN_URLS`: 可选,逗号分隔
23
-
24
- ## Execution Steps
25
-
26
- 1. 解析输入,提取 `REQ_ID`、`TITLE`、`PLAN_URLS`。
27
- 2. 组装 goal 文本:
28
- - `Deliver <REQ_ID>: <TITLE>`
29
- - 若有 URL,追加 `Sources: <URLS>`。
30
- 3. 运行初始化:
31
-
32
- ```bash
33
- npm run harness:init -- --change-id "${REQ_ID}" --goal "${GOAL}"
34
- ```
35
-
36
- 4. 运行上下文打包:
37
-
38
- ```bash
39
- npm run harness:pack -- --change-id "${REQ_ID}" --goal "${GOAL}"
40
- ```
41
-
42
- 5. 验证输出文件:
43
- - `devflow/requirements/${REQ_ID}/harness-state.json`
44
- - `devflow/requirements/${REQ_ID}/context-package.md`
45
-
46
- ## Exit Criteria
47
-
48
- - `harness-state.json.status == "initialized"`
49
- - `context-package.md` 存在并包含 Next Commands 段落
50
-
51
- ## Next Step
52
-
53
- ```bash
54
- /flow:spec "${REQ_ID}"
55
- ```
@@ -1,42 +0,0 @@
1
- ---
2
- name: flow-spec
3
- description: 'Generate and refresh task-manifest for a requirement. Use when converting requirement context into dependency-aware executable tasks.'
4
- ---
5
-
6
- # Flow-Spec Skill
7
-
8
- > [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
9
-
10
- ## Purpose
11
-
12
- 将需求上下文转换为 `task-manifest.json`,作为后续执行唯一任务源。
13
-
14
- ## Input Format
15
-
16
- ```bash
17
- /flow:spec "REQ_ID" [--overwrite]
18
- ```
19
-
20
- ## Execution Steps
21
-
22
- 1. 解析 `REQ_ID` 和可选 `--overwrite`。
23
- 2. 运行计划生成:
24
-
25
- ```bash
26
- npm run harness:plan -- --change-id "${REQ_ID}" [--overwrite]
27
- ```
28
-
29
- 3. 校验输出:
30
- - `devflow/requirements/${REQ_ID}/task-manifest.json`
31
- - `tasks` 数组非空,`id/dependsOn/run` 字段完整
32
-
33
- ## Exit Criteria
34
-
35
- - `task-manifest.json` 可通过 schema 校验
36
- - 任务依赖图无自循环(由 planner 保障)
37
-
38
- ## Next Step
39
-
40
- ```bash
41
- /flow:dev "${REQ_ID}"
42
- ```
File without changes