cc-devflow 4.1.5 → 4.2.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 (112) hide show
  1. package/.claude/CLAUDE.md +87 -1091
  2. package/.claude/commands/core/architecture.md +32 -2
  3. package/.claude/commands/core/guidelines.md +27 -2
  4. package/.claude/commands/core/roadmap.md +33 -4
  5. package/.claude/commands/core/style.md +53 -263
  6. package/.claude/commands/flow/CLAUDE.md +28 -0
  7. package/.claude/commands/flow/archive.md +2 -2
  8. package/.claude/commands/flow/checklist.md +9 -251
  9. package/.claude/commands/flow/clarify.md +9 -127
  10. package/.claude/commands/flow/constitution.md +1 -1
  11. package/.claude/commands/flow/context.md +1 -1
  12. package/.claude/commands/flow/dev.md +19 -395
  13. package/.claude/commands/flow/ideate.md +13 -13
  14. package/.claude/commands/flow/init.md +19 -30
  15. package/.claude/commands/flow/new.md +12 -268
  16. package/.claude/commands/flow/quality.md +10 -153
  17. package/.claude/commands/flow/release.md +18 -81
  18. package/.claude/commands/flow/restart.md +15 -16
  19. package/.claude/commands/flow/spec.md +14 -164
  20. package/.claude/commands/flow/status.md +12 -12
  21. package/.claude/commands/flow/update.md +4 -4
  22. package/.claude/commands/flow/upgrade.md +6 -6
  23. package/.claude/commands/flow/verify.md +19 -78
  24. package/.claude/commands/flow/workspace.md +1 -1
  25. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +7 -7
  26. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +44 -96
  27. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +1 -1
  28. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +5 -5
  29. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +1 -1
  30. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +3 -3
  31. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +5 -5
  32. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +2 -2
  33. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +3 -3
  34. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +33 -64
  35. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +3 -3
  36. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +2 -2
  37. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +2 -2
  38. package/.claude/docs/templates/STYLE_TEMPLATE.md +3 -3
  39. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +8 -9
  40. package/.claude/guides/workflow-guides/flow-orchestrator.md +31 -265
  41. package/.claude/hooks/CLAUDE.md +1 -1
  42. package/.claude/hooks/checklist-gate.js +4 -4
  43. package/.claude/hooks/inject-agent-context.ts +2 -2
  44. package/.claude/scripts/calculate-checklist-completion.sh +2 -2
  45. package/.claude/scripts/check-prerequisites.sh +2 -2
  46. package/.claude/scripts/checklist-errors.sh +4 -4
  47. package/.claude/scripts/flow-quality-full.sh +5 -5
  48. package/.claude/scripts/flow-quality-quick.sh +4 -4
  49. package/.claude/scripts/flow-workspace-init.sh +2 -2
  50. package/.claude/scripts/generate-clarification-report.sh +4 -4
  51. package/.claude/scripts/recover-workflow.sh +70 -73
  52. package/.claude/scripts/run-quality-gates.sh +1 -1
  53. package/.claude/scripts/setup-epic.sh +2 -2
  54. package/.claude/scripts/setup-ralph-loop.sh +2 -2
  55. package/.claude/scripts/validate-research.sh +1 -1
  56. package/.claude/scripts/verify-setup.sh +1 -1
  57. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +113 -108
  58. package/.claude/skills/workflow/CLAUDE.md +24 -0
  59. package/.claude/skills/workflow/flow-dev/CLAUDE.md +14 -76
  60. package/.claude/skills/workflow/flow-dev/SKILL.md +58 -60
  61. package/.claude/skills/workflow/flow-dev/context.jsonl +4 -8
  62. package/.claude/skills/workflow/flow-init/SKILL.md +46 -144
  63. package/.claude/skills/workflow/flow-init/assets/RESEARCH_TEMPLATE.md +1 -1
  64. package/.claude/skills/workflow/flow-init/context.jsonl +3 -3
  65. package/.claude/skills/workflow/flow-init/scripts/check-prerequisites.sh +1 -1
  66. package/.claude/skills/workflow/flow-init/scripts/validate-research.sh +1 -1
  67. package/.claude/skills/workflow/flow-release/SKILL.md +23 -56
  68. package/.claude/skills/workflow/flow-release/context.jsonl +5 -7
  69. package/.claude/skills/workflow/flow-spec/CLAUDE.md +15 -101
  70. package/.claude/skills/workflow/flow-spec/SKILL.md +40 -511
  71. package/.claude/skills/workflow/flow-spec/context.jsonl +5 -7
  72. package/.claude/skills/workflow/flow-verify/CLAUDE.md +10 -0
  73. package/.claude/skills/workflow/flow-verify/SKILL.md +53 -0
  74. package/.claude/skills/workflow/flow-verify/context.jsonl +5 -0
  75. package/.claude/skills/workflow.yaml +72 -267
  76. package/CHANGELOG.md +72 -0
  77. package/README.md +96 -69
  78. package/README.zh-CN.md +95 -67
  79. package/bin/cc-devflow-cli.js +154 -0
  80. package/bin/harness.js +22 -0
  81. package/docs/commands/README.md +34 -38
  82. package/docs/commands/README.zh-CN.md +34 -36
  83. package/docs/commands/core-roadmap.md +2 -2
  84. package/docs/commands/core-roadmap.zh-CN.md +2 -2
  85. package/docs/commands/core-style.md +29 -381
  86. package/docs/commands/core-style.zh-CN.md +29 -381
  87. package/docs/commands/flow-init.md +10 -10
  88. package/docs/commands/flow-init.zh-CN.md +11 -11
  89. package/docs/commands/flow-new.md +25 -260
  90. package/docs/commands/flow-new.zh-CN.md +26 -257
  91. package/docs/guides/getting-started.md +16 -15
  92. package/docs/guides/getting-started.zh-CN.md +10 -12
  93. package/lib/compiler/__tests__/manifest.test.js +156 -0
  94. package/lib/compiler/__tests__/parser.test.js +21 -0
  95. package/lib/compiler/index.js +17 -1
  96. package/lib/compiler/manifest.js +68 -6
  97. package/lib/compiler/parser.js +5 -0
  98. package/lib/harness/CLAUDE.md +21 -0
  99. package/lib/harness/cli.js +208 -0
  100. package/lib/harness/index.js +16 -0
  101. package/lib/harness/operations/dispatch.js +285 -0
  102. package/lib/harness/operations/init.js +48 -0
  103. package/lib/harness/operations/janitor.js +74 -0
  104. package/lib/harness/operations/pack.js +100 -0
  105. package/lib/harness/operations/plan.js +29 -0
  106. package/lib/harness/operations/release.js +83 -0
  107. package/lib/harness/operations/resume.js +44 -0
  108. package/lib/harness/operations/verify.js +163 -0
  109. package/lib/harness/planner.js +141 -0
  110. package/lib/harness/schemas.js +108 -0
  111. package/lib/harness/store.js +240 -0
  112. package/package.json +9 -1
@@ -1,103 +1,17 @@
1
- # flow-spec/ - Unified Specification Skill
2
-
3
- > L2 | 父级: `.claude/skills/workflow/CLAUDE.md`
4
-
5
- ## Purpose
6
-
7
- 统一规格阶段,合并 flow-prd/flow-tech/flow-ui/flow-epic 为单一命令。支持 Team Mode 并行协作 (v4.7)。
8
-
9
- ## Members
10
-
11
- | File | Purpose | Lines |
12
- |------|---------|-------|
13
- | `SKILL.md` | 核心指令:执行流程、模式、错误处理 | ~250 |
14
- | `context.jsonl` | 上下文注入定义 | ~10 |
15
- | `team-config.json` | Team Mode 配置:成员、工作流、协商协议 [v4.7] | ~165 |
16
- | `scripts/entry-gate.sh` | 统一入口检查 | ~150 |
17
- | `scripts/parallel-orchestrator.sh` | 并行调度逻辑文档 | ~200 |
18
- | `scripts/exit-gate.sh` | 统一出口检查 | ~180 |
19
- | `scripts/team-init.sh` | Team Mode 初始化脚本 [v4.7] | ~190 |
20
- | `scripts/team-communication.sh` | Team 通信协议脚本 [v4.7] | ~280 |
21
-
22
- ## Execution Flow
23
-
24
- ```
25
- PRD (sequential) → Tech + UI (parallel) → Epic (sequential)
26
- ```
27
-
28
- ## Mode Matrix
29
-
30
- | Mode | Flags | Agents |
31
- |------|-------|--------|
32
- | Full | (default) | PRD + Tech + UI + Epic |
33
- | Quick | `--skip-tech --skip-ui` | PRD + Epic |
34
- | Backend | `--skip-ui` | PRD + Tech + Epic |
35
- | Frontend | `--skip-tech` | PRD + UI + Epic |
36
-
37
- ## Agent References
38
-
39
- 复用现有 agent 指令:
40
- - `flow-prd/references/prd-writer.md`
41
- - `flow-tech/references/tech-architect.md`
42
- - `flow-ui/references/ui-designer.md`
43
- - `flow-epic/references/planner.md`
44
-
45
- ## Team Mode (v4.7)
46
-
47
- ### 执行模式检测
48
-
49
- | Mode | Flags | Execution |
50
- |------|-------|-----------|
51
- | Team (Full) | (default) | 并行 Team 协作 |
52
- | Subagent (Quick) | `--skip-tech --skip-ui` | 传统 Subagent |
53
- | Subagent (Backend) | `--skip-ui` | 传统 Subagent |
54
- | Subagent (Frontend) | `--skip-tech` | 传统 Subagent |
55
-
56
- ### team-config.json
57
-
58
- 定义 spec-design-team 的完整配置:
59
-
60
- - **members**: 4 个 Agent (prd-writer, tech-architect, ui-designer, planner)
61
- - **workflow.stages**: 3 阶段执行流程
62
- - **communication.negotiate_topics**: 5 个协商主题 (api_format, field_naming, auth_strategy, state_management, component_granularity)
63
- - **quality_gates**: 入口/出口检查配置
64
- - **error_handling**: 阶段失败处理策略
65
-
66
- ### scripts/team-init.sh
67
-
68
- Team Mode 初始化脚本,提供:
69
-
70
- - `detect`: 检测执行模式 (team/subagent)
71
- - `init`: 初始化 Team 状态到 orchestration_status.json
72
- - `config`: 输出 Team 配置 JSON
73
-
74
- ### scripts/team-communication.sh
75
-
76
- Team 通信协议脚本,提供:
77
-
78
- - `init`: 初始化 design_decisions.md
79
- - `record`: 记录设计决策
80
- - `template`: 获取协商消息模板
81
- - `participants`: 获取主题参与者
82
- - `owner`: 获取决策所有者
83
- - `example-api`: API 格式协商示例
84
- - `example-state`: 状态管理协商示例
85
-
86
- ### SendMessage 协商协议 (v4.7)
87
-
88
- Team Mode 下 tech-architect 和 ui-designer 通过 SendMessage 工具进行实时协商:
89
-
90
- | Topic | Initiator | Decision Owner | 协商内容 |
91
- |-------|-----------|----------------|----------|
92
- | api_format | tech-architect | tech-architect | REST/GraphQL, 分页, 错误格式 |
93
- | field_naming | tech-architect | tech-architect | camelCase/snake_case, 字段命名 |
94
- | auth_strategy | tech-architect | tech-architect | JWT/Session/OAuth |
95
- | state_management | ui-designer | ui-designer | Zustand/Redux/Context |
96
-
97
- 协商结果记录到 `devflow/requirements/{REQ}/research/design_decisions.md`。
98
-
99
- 详细协商消息模板见 `SKILL.md` Stage 2 Negotiate Protocol 部分。
100
-
101
- ---
1
+ # flow-spec/
2
+ > L2 | 父级: /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/.claude/skills/workflow/CLAUDE.md
3
+
4
+ 成员清单
5
+ SKILL.md: flow:spec 的核心指令,定义 harness:plan 任务清单生成流程。
6
+ context.jsonl: flow-spec 上下文注入定义(context-package/task-manifest/harness-state)。
7
+ team-config.json: Team 模式配置资产(兼容保留,当前主链不依赖)。
8
+ scripts/entry-gate.sh: 旧入口脚本资产(兼容保留)。
9
+ scripts/parallel-orchestrator.sh: 旧并行编排脚本资产(兼容保留)。
10
+ scripts/exit-gate.sh: 旧出口脚本资产(兼容保留)。
11
+ scripts/team-init.sh: Team 初始化脚本资产(兼容保留)。
12
+ scripts/team-communication.sh: 旧 Team 通信脚本资产(兼容保留)。
13
+ scripts/test-team-mode.sh: Team 模式测试脚本资产(兼容保留)。
14
+
15
+ 法则: 成员完整·一行一文件·父级链接·技术词前置
102
16
 
103
17
  [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md