cc-devflow 4.5.0 → 4.5.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/skills/cc-act/CHANGELOG.md +14 -0
- package/.claude/skills/cc-act/PLAYBOOK.md +26 -1
- package/.claude/skills/cc-act/SKILL.md +36 -7
- package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +20 -0
- package/.claude/skills/cc-act/references/closure-contract.md +8 -0
- package/.claude/skills/cc-act/scripts/cc-act-common.sh +6 -1
- package/.claude/skills/cc-act/scripts/render-pr-brief.sh +99 -0
- package/.claude/skills/cc-act/scripts/verify-act-gate.sh +17 -1
- package/.claude/skills/cc-check/CHANGELOG.md +14 -0
- package/.claude/skills/cc-check/PLAYBOOK.md +101 -1
- package/.claude/skills/cc-check/SKILL.md +128 -7
- package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +121 -1
- package/.claude/skills/cc-check/references/review-contract.md +88 -0
- package/.claude/skills/cc-check/scripts/render-report-card.js +172 -5
- package/.claude/skills/cc-check/scripts/verify-gate.sh +21 -0
- package/.claude/skills/cc-investigate/CHANGELOG.md +13 -0
- package/.claude/skills/cc-investigate/PLAYBOOK.md +105 -4
- package/.claude/skills/cc-investigate/SKILL.md +185 -8
- package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +77 -3
- package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +10 -3
- package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +102 -1
- package/.claude/skills/cc-investigate/references/investigation-contract.md +146 -0
- package/.claude/skills/cc-plan/CHANGELOG.md +14 -0
- package/.claude/skills/cc-plan/PLAYBOOK.md +19 -2
- package/.claude/skills/cc-plan/SKILL.md +52 -20
- package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +70 -1
- package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +13 -0
- package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +3 -1
- package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +22 -0
- package/.claude/skills/cc-roadmap/CHANGELOG.md +12 -0
- package/.claude/skills/cc-roadmap/PLAYBOOK.md +24 -1
- package/.claude/skills/cc-roadmap/SKILL.md +50 -15
- package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +15 -0
- package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +37 -0
- package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +2 -1
- package/.claude/skills/cc-simplify/CHANGELOG.md +15 -0
- package/.claude/skills/cc-simplify/SKILL.md +255 -35
- package/CHANGELOG.md +36 -0
- package/CODE_OF_CONDUCT.md +39 -0
- package/CODE_OF_CONDUCT.zh-CN.md +39 -0
- package/CONTRIBUTING.md +195 -0
- package/CONTRIBUTING.zh-CN.md +195 -0
- package/README.md +141 -150
- package/README.zh-CN.md +144 -148
- package/SECURITY.md +56 -0
- package/SECURITY.zh-CN.md +56 -0
- package/docs/examples/example-bindings.json +6 -6
- package/docs/examples/full-design-blocked/BACKLOG.md +1 -1
- package/docs/examples/full-design-blocked/README.md +1 -1
- package/docs/examples/full-design-blocked/ROADMAP.md +1 -1
- package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +1 -1
- package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +1 -1
- package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +140 -3
- package/docs/examples/full-design-blocked/roadmap-tracking.json +1 -1
- package/docs/examples/local-handoff/BACKLOG.md +1 -1
- package/docs/examples/local-handoff/README.md +1 -1
- package/docs/examples/local-handoff/ROADMAP.md +1 -1
- package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +1 -1
- package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +1 -1
- package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +92 -0
- package/docs/examples/local-handoff/roadmap-tracking.json +1 -1
- package/docs/examples/pdca-loop/BACKLOG.md +1 -1
- package/docs/examples/pdca-loop/README.md +1 -1
- package/docs/examples/pdca-loop/ROADMAP.md +1 -1
- package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +20 -0
- package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +1 -1
- package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +2 -2
- package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +1 -1
- package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +92 -0
- package/docs/examples/pdca-loop/roadmap-tracking.json +1 -1
- package/docs/guides/getting-started.md +5 -0
- package/docs/guides/getting-started.zh-CN.md +5 -0
- package/lib/skill-runtime/review.js +64 -1
- package/lib/skill-runtime/schemas.js +150 -3
- package/package.json +7 -1
|
@@ -61,20 +61,29 @@
|
|
|
61
61
|
|
|
62
62
|
### Option A
|
|
63
63
|
|
|
64
|
+
- Role: `minimal viable` | `ideal architecture` | `hybrid`
|
|
64
65
|
- Shape:
|
|
65
66
|
- Reuses:
|
|
67
|
+
- Completeness:
|
|
66
68
|
- Pros:
|
|
67
69
|
- Cons:
|
|
68
70
|
- Risks:
|
|
69
71
|
|
|
70
72
|
### Option B
|
|
71
73
|
|
|
74
|
+
- Role: `minimal viable` | `ideal architecture` | `hybrid`
|
|
72
75
|
- Shape:
|
|
73
76
|
- Reuses:
|
|
77
|
+
- Completeness:
|
|
74
78
|
- Pros:
|
|
75
79
|
- Cons:
|
|
76
80
|
- Risks:
|
|
77
81
|
|
|
82
|
+
### Eliminated Options
|
|
83
|
+
|
|
84
|
+
- Option:
|
|
85
|
+
- Why eliminated:
|
|
86
|
+
|
|
78
87
|
## Approved Direction
|
|
79
88
|
|
|
80
89
|
- Approved option:
|
|
@@ -92,6 +101,15 @@
|
|
|
92
101
|
- Error handling:
|
|
93
102
|
- Rollout / migration:
|
|
94
103
|
|
|
104
|
+
## Implementation Decision Horizon
|
|
105
|
+
|
|
106
|
+
| Phase | Decision `cc-do` would otherwise hit | Frozen answer | Evidence / owner |
|
|
107
|
+
|-------|--------------------------------------|---------------|------------------|
|
|
108
|
+
| Foundation | | | |
|
|
109
|
+
| Core logic | | | |
|
|
110
|
+
| Integration | | | |
|
|
111
|
+
| Polish / tests | | | |
|
|
112
|
+
|
|
95
113
|
## Invariant Impact
|
|
96
114
|
|
|
97
115
|
- Affected invariants:
|
|
@@ -112,16 +130,62 @@
|
|
|
112
130
|
|
|
113
131
|
> 如果文件计划超过 5-8 个文件,先问自己:这是不是已经逼近 `full-design` 之外的需求膨胀。
|
|
114
132
|
|
|
133
|
+
## Implementation Surface Map
|
|
134
|
+
|
|
135
|
+
| Surface | Responsibility | Why here | Coupling risk | Split / merge decision |
|
|
136
|
+
|---------|----------------|----------|---------------|------------------------|
|
|
137
|
+
| | | | | |
|
|
138
|
+
|
|
139
|
+
> 先锁定文件职责,再拆任务。执行者不应该在 `cc-do` 阶段重新决定代码该放哪里。
|
|
140
|
+
|
|
115
141
|
## Validation Strategy
|
|
116
142
|
|
|
143
|
+
- Test framework source:
|
|
117
144
|
- First failing tests:
|
|
118
145
|
- Red/Green/Refactor task chain:
|
|
119
146
|
- TDD exceptions:
|
|
147
|
+
- Regression tests required:
|
|
120
148
|
- Unit:
|
|
121
149
|
- Integration:
|
|
150
|
+
- E2E:
|
|
151
|
+
- Eval:
|
|
122
152
|
- Manual:
|
|
123
153
|
- Observability / evidence:
|
|
124
154
|
|
|
155
|
+
## Test Coverage Map
|
|
156
|
+
|
|
157
|
+
| Code path / user flow | Existing coverage | Quality | Required test | Level | Regression? |
|
|
158
|
+
|-----------------------|-------------------|---------|---------------|-------|-------------|
|
|
159
|
+
| | | strong / happy-path-only / smoke-only / missing | | unit / integration / e2e / eval | Yes / No |
|
|
160
|
+
|
|
161
|
+
## Error & Rescue Map
|
|
162
|
+
|
|
163
|
+
| Codepath | What can fail | Rescue action | User sees | Test evidence |
|
|
164
|
+
|----------|---------------|---------------|-----------|---------------|
|
|
165
|
+
| | | | | |
|
|
166
|
+
|
|
167
|
+
## UI Design Gate
|
|
168
|
+
|
|
169
|
+
- Applies: Yes / No
|
|
170
|
+
- Design completeness score:
|
|
171
|
+
- What 10/10 means here:
|
|
172
|
+
- Existing design patterns to reuse:
|
|
173
|
+
- State coverage:
|
|
174
|
+
|
|
175
|
+
| Feature | Loading | Empty | Error | Success | Partial |
|
|
176
|
+
|---------|---------|-------|-------|---------|---------|
|
|
177
|
+
| | | | | | |
|
|
178
|
+
|
|
179
|
+
## DX / Operator Gate
|
|
180
|
+
|
|
181
|
+
- Applies: Yes / No
|
|
182
|
+
- Target developer / operator:
|
|
183
|
+
- Current first-success path:
|
|
184
|
+
- Target time to first value:
|
|
185
|
+
- Magic moment:
|
|
186
|
+
- Install / run / debug / upgrade risks:
|
|
187
|
+
- Required docs / examples / entrypoints:
|
|
188
|
+
|
|
125
189
|
## Risks
|
|
126
190
|
|
|
127
191
|
| Risk | Impact | Mitigation |
|
|
@@ -136,9 +200,14 @@
|
|
|
136
200
|
- Ambiguity scan:
|
|
137
201
|
- Feasibility scan:
|
|
138
202
|
- Source alignment:
|
|
203
|
+
- Implementation surface scan:
|
|
204
|
+
- Decision horizon scan:
|
|
205
|
+
- Error & rescue scan:
|
|
206
|
+
- Test framework / regression scan:
|
|
139
207
|
- UI / interaction review summary:
|
|
140
|
-
- DX review summary:
|
|
208
|
+
- DX / operator review summary:
|
|
141
209
|
- Test-first readiness:
|
|
210
|
+
- Review calibration:
|
|
142
211
|
- Auto-decided items:
|
|
143
212
|
- Taste decisions:
|
|
144
213
|
- User challenges:
|
|
@@ -19,13 +19,23 @@
|
|
|
19
19
|
- Capability specs:
|
|
20
20
|
- Read first:
|
|
21
21
|
- Commands to trust:
|
|
22
|
+
- Test framework source:
|
|
22
23
|
- TDD plan: `Red -> Green -> Refactor`
|
|
23
24
|
- TDD exceptions: none | list exception reason, risk, replacement evidence, follow-up
|
|
25
|
+
- Regression tests: required | not applicable, with reason
|
|
24
26
|
- Do not re-decide:
|
|
25
27
|
- Parallel boundaries:
|
|
26
28
|
|
|
27
29
|
> 顶部 handoff 只保留执行者必须知道的现实,不重复讲背景故事。
|
|
28
30
|
|
|
31
|
+
## Implementation Surface Map
|
|
32
|
+
|
|
33
|
+
| Surface | Responsibility | Tasks | Coupling risk |
|
|
34
|
+
|---------|----------------|-------|---------------|
|
|
35
|
+
| | | | |
|
|
36
|
+
|
|
37
|
+
> 这张表是执行边界,不是装饰。任务拆分必须沿着这些职责走,不能让 `cc-do` 临场重切文件归属。
|
|
38
|
+
|
|
29
39
|
## Phase 1: Foundation
|
|
30
40
|
|
|
31
41
|
- [ ] T001 [TEST] Write the first failing test (dependsOn:none) `path/to/test`
|
|
@@ -35,6 +45,7 @@
|
|
|
35
45
|
Read first: `design.md`, `tasks.md`
|
|
36
46
|
Verification: `npm test -- path/to/test`
|
|
37
47
|
Evidence: failing output
|
|
48
|
+
Coverage: unit / integration / e2e / eval; regression: yes / no
|
|
38
49
|
Ready when: 没有上游依赖,且测试路径已经确定
|
|
39
50
|
|
|
40
51
|
- [ ] T002 [IMPL] Make the first test pass (dependsOn:T001) `path/to/file`
|
|
@@ -55,6 +66,7 @@
|
|
|
55
66
|
Read first: `design.md`, `tasks.md`
|
|
56
67
|
Verification: `npm test -- path/to/other.test`
|
|
57
68
|
Evidence: failing output
|
|
69
|
+
Coverage: unit / integration / e2e / eval; regression: yes / no
|
|
58
70
|
Ready when: T002 完成,且该测试覆盖的是独立行为
|
|
59
71
|
|
|
60
72
|
- [ ] T004 [P] [IMPL] Make the independent test pass (dependsOn:T003) `path/to/other-file`
|
|
@@ -97,3 +109,4 @@
|
|
|
97
109
|
- 用哪条命令证明它完成
|
|
98
110
|
- 要留下什么证据给 `cc-check`
|
|
99
111
|
- 它处于 Red、Green、Refactor,还是明确的 TDD exception
|
|
112
|
+
- 测试框架依据来自哪里,回归测试是否被明确处理
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
]
|
|
21
21
|
},
|
|
22
22
|
"planningMeta": {
|
|
23
|
-
"reqPlanSkillVersion": "3.5.
|
|
23
|
+
"reqPlanSkillVersion": "3.5.6",
|
|
24
24
|
"designVersion": "design.v1",
|
|
25
25
|
"approvedAt": "2026-04-15T12:00:00.000Z",
|
|
26
26
|
"approvedBy": "user",
|
|
@@ -29,6 +29,8 @@
|
|
|
29
29
|
"executionDiscipline": {
|
|
30
30
|
"default": "red-green-refactor",
|
|
31
31
|
"testFirstRequired": true,
|
|
32
|
+
"testFrameworkSource": "",
|
|
33
|
+
"regressionTestsRequired": [],
|
|
32
34
|
"tddExceptions": []
|
|
33
35
|
},
|
|
34
36
|
"status": "planned",
|
|
@@ -43,16 +43,35 @@
|
|
|
43
43
|
- Key decisions that `cc-do` must not re-decide:
|
|
44
44
|
- Upgrade trigger to `full-design`:
|
|
45
45
|
|
|
46
|
+
> `tiny-design` 是短设计,不是免设计。没有明确批准状态、验证证据和升级触发条件,就不能继续拆任务。
|
|
47
|
+
|
|
48
|
+
## Implementation Surface Map
|
|
49
|
+
|
|
50
|
+
| Surface | Responsibility | Why here | Coupling risk |
|
|
51
|
+
|---------|----------------|----------|---------------|
|
|
52
|
+
| | | | |
|
|
53
|
+
|
|
46
54
|
## Validation
|
|
47
55
|
|
|
56
|
+
- Test framework source:
|
|
48
57
|
- First failing test:
|
|
49
58
|
- Green implementation check:
|
|
50
59
|
- Refactor checkpoint:
|
|
51
60
|
- TDD exceptions:
|
|
61
|
+
- Regression test required:
|
|
52
62
|
- Primary check:
|
|
53
63
|
- Secondary checks:
|
|
54
64
|
- Evidence to collect:
|
|
55
65
|
|
|
66
|
+
## Conditional Design Checks
|
|
67
|
+
|
|
68
|
+
- UI / interaction scope: Yes / No
|
|
69
|
+
- UI state coverage if applicable:
|
|
70
|
+
- Developer / operator-facing scope: Yes / No
|
|
71
|
+
- Target developer / operator if applicable:
|
|
72
|
+
- Time to first value if applicable:
|
|
73
|
+
- Magic moment if applicable:
|
|
74
|
+
|
|
56
75
|
## Main Risk
|
|
57
76
|
|
|
58
77
|
- Risk:
|
|
@@ -65,7 +84,10 @@
|
|
|
65
84
|
- Scope scan:
|
|
66
85
|
- Ambiguity scan:
|
|
67
86
|
- Feasibility scan:
|
|
87
|
+
- Implementation surface scan:
|
|
88
|
+
- Test framework / regression scan:
|
|
68
89
|
- Test-first readiness:
|
|
90
|
+
- Review calibration:
|
|
69
91
|
- Final recommendation:
|
|
70
92
|
|
|
71
93
|
## Approval
|
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# Roadmap Skill Changelog
|
|
2
2
|
|
|
3
|
+
## v4.3.4 - 2026-04-28
|
|
4
|
+
|
|
5
|
+
- add planning posture and evidence maturity routing so roadmap questions match idea, user, paying, infra, or recovery contexts
|
|
6
|
+
- require a framing check before route recommendation so vague users, hypothetical demand, and undefined status quo do not pass as evidence
|
|
7
|
+
- add developer/operator adoption handoff fields for target user, time to first value, magic moment, and install/run/debug/upgrade bottlenecks
|
|
8
|
+
|
|
9
|
+
## v4.3.3 - 2026-04-28
|
|
10
|
+
|
|
11
|
+
- add a decomposition-first route for asks that bundle multiple independently shippable subsystems
|
|
12
|
+
- require roadmap entry and approval gates to split over-broad goals into stages and RM candidates before implementation detail discovery
|
|
13
|
+
- add subsystem decomposition and handoff notes to roadmap/backlog templates
|
|
14
|
+
|
|
3
15
|
## v4.3.2 - 2026-04-27
|
|
4
16
|
|
|
5
17
|
- require roadmap outputs to resolve the runtime output policy before writing durable roadmap/backlog documents
|
|
@@ -16,6 +16,9 @@
|
|
|
16
16
|
4. 通过 `roadmap` 只能产出方向,不能偷拆实现任务。
|
|
17
17
|
5. 没有证据时写 assumption,不准冒充事实。
|
|
18
18
|
6. 每次都必须明确推荐一条路线,不准只列选项不下判断。
|
|
19
|
+
7. 多个独立子系统混在一个目标里时,先拆阶段和 `RM` 候选,不要继续追问实现细节。
|
|
20
|
+
8. 先判断 planning posture 和 evidence maturity,再决定追问哪些问题;不要用同一套问题硬套 idea、已有用户、付费客户、infra 和 recovery 场景。
|
|
21
|
+
9. developer-facing / operator-facing 路线必须写清 target user、time to first value、magic moment 和 adoption bottleneck。
|
|
19
22
|
|
|
20
23
|
## Local Kit
|
|
21
24
|
|
|
@@ -37,6 +40,9 @@
|
|
|
37
40
|
3. 最近相关 docs / specs / plans
|
|
38
41
|
4. 最近相关提交、当前工作树状态、正在推进的 requirement
|
|
39
42
|
5. 现实 forcing functions:deadline、distribution、资源、依赖、当前卡点
|
|
43
|
+
6. planning posture:startup / internal / hackathon / OSS / research / learning / side-project / infrastructure
|
|
44
|
+
7. evidence maturity:idea / has users / paying users / internal sponsor / infra-only / recovery
|
|
45
|
+
8. developer / operator adoption 线索:目标人、first success path、TTHW / time to first value、debug / upgrade 卡点
|
|
40
46
|
|
|
41
47
|
先把这些材料压成 `Context Snapshot`,再追问用户。
|
|
42
48
|
|
|
@@ -57,11 +63,22 @@
|
|
|
57
63
|
8. 当前最大的 adoption / trust / delivery 卡点是什么
|
|
58
64
|
9. 成功与失败的判断信号是什么
|
|
59
65
|
|
|
66
|
+
第一轮答案之后做 framing check:术语是否具体、用户是否可命名、pain 是否来自真实行为、status quo 是否明确、需求证据是否强过“感兴趣”。如果答案虚,先收紧问题,不要急着定路线。
|
|
67
|
+
|
|
68
|
+
## Evidence-Maturity Routing
|
|
69
|
+
|
|
70
|
+
- `idea / pre-product`: 先追真实用户、现状替代方案、最窄 wedge、需求证据。
|
|
71
|
+
- `has users`: 先追现有路径、失败/绕路场景、使用保留信号、下一阶段 wedge。
|
|
72
|
+
- `paying users / internal sponsor`: 先追付费/赞助动机、扩张边界、信任信号、组织风险。
|
|
73
|
+
- `infra-only`: 先追调用方、瓶颈、复用边界、迁移/回滚约束。
|
|
74
|
+
- `recovery / trust gap`: 先追事故证据、恢复路径、最小可信修复、停止扩张的 kill signal。
|
|
75
|
+
|
|
60
76
|
## Route Shapes
|
|
61
77
|
|
|
62
78
|
- `wedge-first`: 用一个极窄切口先打穿真实需求
|
|
63
79
|
- `platform-first`: 先搭通后续阶段复用的关键底座
|
|
64
80
|
- `rescue-first`: 先解决当前最大的 adoption / trust / delivery 卡点
|
|
81
|
+
- `decompose-first`: 先把多个可独立交付的子系统拆成阶段和 `RM`,再选择主线
|
|
65
82
|
|
|
66
83
|
推荐时必须回答:为什么这条主线比其他两条更值得先打。
|
|
67
84
|
|
|
@@ -73,6 +90,7 @@
|
|
|
73
90
|
2. 有没有明确说“不先做另外两条”的原因?
|
|
74
91
|
3. Stage 1 的 win signal 能不能在 1-2 个周期内看到?
|
|
75
92
|
4. 如果 Stage 1 输了,kill signal 是不是具体到可以止损?
|
|
93
|
+
5. 当前问题路由是否匹配 evidence maturity,而不是为了完整感把所有问题都问一遍?
|
|
76
94
|
|
|
77
95
|
## Stage Contract
|
|
78
96
|
|
|
@@ -84,7 +102,8 @@
|
|
|
84
102
|
4. `Exit signal`
|
|
85
103
|
5. `Kill signal`
|
|
86
104
|
6. `Non-goals`
|
|
87
|
-
7.
|
|
105
|
+
7. 子系统 / `RM` 边界,说明哪些合并、哪些拆开
|
|
106
|
+
8. 可以自然长成下一轮 `cc-plan` 的候选事项
|
|
88
107
|
|
|
89
108
|
## Dependency Contract
|
|
90
109
|
|
|
@@ -98,6 +117,7 @@
|
|
|
98
117
|
`devflow/ROADMAP.md`
|
|
99
118
|
- version / skill version / context snapshot / evidence ledger
|
|
100
119
|
- 1-3 个阶段
|
|
120
|
+
- 独立子系统拆分判断
|
|
101
121
|
- 每阶段目标
|
|
102
122
|
- 每阶段存在原因
|
|
103
123
|
- 每阶段 dependencies
|
|
@@ -111,6 +131,7 @@
|
|
|
111
131
|
`devflow/BACKLOG.md`
|
|
112
132
|
- 只保留会真的进入下一轮 `cc-plan` 的事项
|
|
113
133
|
- 每项注明来源阶段、优先级、证据、`Depends On`、`Parallel With`、当前未知点、下一决策、是否 ready
|
|
134
|
+
- developer-facing / operator-facing 条目要带 target user、time to first value、magic moment 和 adoption bottleneck,方便 `cc-plan` 继续做 DX 设计
|
|
114
135
|
- `Backlog Meta`、`Queue`、`Dependency Handoff`、`Ready For Req-Plan`、`Parked` 可由 `devflow/roadmap-tracking.json` 回渲染,避免 roadmap truth 和 backlog handoff 分叉
|
|
115
136
|
|
|
116
137
|
## Review Loop
|
|
@@ -123,6 +144,8 @@
|
|
|
123
144
|
4. `RM Dependency Graph` 是否只有硬依赖、没有环
|
|
124
145
|
5. ready 项是否真能进入 `cc-plan`
|
|
125
146
|
6. 本次版本相比上一版到底改了什么
|
|
147
|
+
7. 问题路由是否匹配 planning posture / evidence maturity
|
|
148
|
+
8. developer-facing / operator-facing item 是否能说明 first value 为什么会发生
|
|
126
149
|
|
|
127
150
|
## Versioning
|
|
128
151
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: cc-roadmap
|
|
3
|
-
version: 4.3.
|
|
3
|
+
version: 4.3.4
|
|
4
4
|
description: "Use when defining, resetting, or narrowing project direction, stage order, or backlog priority before a concrete requirement enters the PDCA loop."
|
|
5
5
|
triggers:
|
|
6
6
|
- "帮我定路线图"
|
|
@@ -32,6 +32,8 @@ writes:
|
|
|
32
32
|
entry_gate:
|
|
33
33
|
- "Read current roadmap, backlog, related capability specs, and surrounding repo context before proposing direction."
|
|
34
34
|
- "Confirm this is a project-direction problem, not a single requirement execution problem."
|
|
35
|
+
- "Classify planning posture and evidence maturity before selecting the route or forcing questions."
|
|
36
|
+
- "If the ask contains multiple independent subsystems, decompose them into stages and RM candidates before refining any implementation detail."
|
|
35
37
|
- "Do not decompose implementation tasks while the roadmap is still being decided."
|
|
36
38
|
exit_criteria:
|
|
37
39
|
- "The next 1-3 stages are frozen with goal, why now, dependencies, exit signal, kill signal, and non-goals."
|
|
@@ -95,12 +97,13 @@ tool_budget:
|
|
|
95
97
|
| “不知道下一步做什么” | 主线不清 | `wedge-first` |
|
|
96
98
|
| “后面几阶段都会重复碰同一底座” | 底座风险 | `platform-first` |
|
|
97
99
|
| “增长/交付/信任卡住了” | 当前最大瓶颈 | `rescue-first` |
|
|
100
|
+
| “一个目标里塞了多个可独立交付系统” | 边界过宽 | `decompose-first` |
|
|
98
101
|
|
|
99
102
|
先给一个**默认推荐**,再解释为什么,不要把用户扔进开放式战略讨论。
|
|
100
103
|
|
|
101
104
|
## Harness Contract
|
|
102
105
|
|
|
103
|
-
- Allowed actions: read current strategy files, repo context, and recent reality; compare route shapes; write `devflow/ROADMAP.md`, `devflow/BACKLOG.md`, and the optional `devflow/roadmap-tracking.json` sidecar used by bundled helpers as the shared roadmap/backlog truth source.
|
|
106
|
+
- Allowed actions: read current strategy files, repo context, and recent reality; compare route shapes; decompose independent subsystems into stages and RM candidates; write `devflow/ROADMAP.md`, `devflow/BACKLOG.md`, and the optional `devflow/roadmap-tracking.json` sidecar used by bundled helpers as the shared roadmap/backlog truth source.
|
|
104
107
|
- Forbidden actions: decompose implementation tasks, invent hidden context, or jump into `cc-plan` before the roadmap is approved.
|
|
105
108
|
- Required evidence: every stage and backlog item must point back to explicit repo facts, user constraints, or observed market signals.
|
|
106
109
|
- Reroute rule: once the conversation collapses to one concrete requirement, stop strategic expansion and hand off to `cc-plan`.
|
|
@@ -109,8 +112,9 @@ tool_budget:
|
|
|
109
112
|
|
|
110
113
|
1. 如果 `devflow/ROADMAP.md` / `devflow/BACKLOG.md` 已存在,先读现状再重写。
|
|
111
114
|
2. 先判断这是“项目方向问题”还是“单 requirement 执行问题”。
|
|
112
|
-
3.
|
|
113
|
-
4.
|
|
115
|
+
3. 如果输入是多个独立子系统的混合目标,先拆成阶段和 `RM` 候选;不要继续追问某个子系统的实现细节。
|
|
116
|
+
4. 先做一次上下文扫描,不能跳过现有事实直接写愿景。
|
|
117
|
+
5. 方向没被批准前,不准把 roadmap 偷偷下放成实现任务。
|
|
114
118
|
|
|
115
119
|
## Context Sweep
|
|
116
120
|
|
|
@@ -122,20 +126,38 @@ tool_budget:
|
|
|
122
126
|
4. 最近相关提交、当前分支脏状态、正在进行中的 requirement。
|
|
123
127
|
5. 真实 forcing functions:deadline、发布窗口、资源上限、依赖、distribution、adoption / trust / delivery 卡点。
|
|
124
128
|
6. 当前项目最强的现实证据,以及仍然只能靠假设的空白。
|
|
129
|
+
7. Planning posture:startup / internal / hackathon / OSS / research / learning / side-project / infrastructure。
|
|
130
|
+
8. Evidence maturity:idea / has users / paying users / internal sponsor / infra-only / recovery。
|
|
131
|
+
9. 如果是 developer-facing 或 operator-facing 能力,补齐 target developer/operator、time to first value、magic moment、install / run / debug / upgrade 卡点。
|
|
125
132
|
|
|
126
133
|
先把这些材料压成一个 `Context Snapshot`,再开始追问用户。
|
|
127
134
|
|
|
135
|
+
## Evidence-Maturity Routing
|
|
136
|
+
|
|
137
|
+
不要对所有项目套同一组问题。先用 `planning posture` 和 `evidence maturity` 决定追问深度:
|
|
138
|
+
|
|
139
|
+
| Evidence maturity | 优先追问 | 不要浪费时间在 |
|
|
140
|
+
| --- | --- | --- |
|
|
141
|
+
| idea / pre-product | 真实用户、status quo、最窄 wedge、需求证据 | 远期平台架构细节 |
|
|
142
|
+
| has users | 现有使用路径、失败/绕路场景、保留率或复用信号、下一阶段 wedge | 假想 persona |
|
|
143
|
+
| paying users / internal sponsor | 付费/赞助动机、扩张边界、不可丢的信任信号、组织风险 | 泛泛市场教育 |
|
|
144
|
+
| infra-only | 当前瓶颈、调用方、现有 workaround、复用边界、迁移/回滚约束 | 伪装成用户访谈的问题 |
|
|
145
|
+
| recovery / trust gap | 事故证据、恢复路径、最小可信修复、停止继续扩张的 kill signal | 新功能愿景 |
|
|
146
|
+
|
|
147
|
+
第一轮回答后必须做 framing check:术语是否具体、用户是否可命名、痛点是否有行为证据、status quo 是否真实、需求是否只是兴趣。发现答案虚,要先收紧问题,再谈路线。
|
|
148
|
+
|
|
128
149
|
## Session Protocol
|
|
129
150
|
|
|
130
151
|
1. 先探索上下文,不靠默认上下文注入替代阅读。
|
|
131
152
|
2. 先问现实,不先写愿景。
|
|
132
153
|
3. 一次只推进一个关键未知点,不要一口气抛一串问题。
|
|
133
|
-
4. 先写 `Context Snapshot
|
|
154
|
+
4. 先写 `Context Snapshot`、planning posture、evidence maturity、证据、约束、非目标,再讨论阶段。
|
|
134
155
|
5. 给出 2-3 种路线图形状,再明确推荐一种,并说明为什么其他路线现在不值得打。
|
|
135
|
-
6.
|
|
136
|
-
7.
|
|
137
|
-
8.
|
|
138
|
-
9.
|
|
156
|
+
6. 如果一个方向里有多个可独立交付的子系统,先写清 decomposition:哪些合并为同一阶段,哪些拆成独立 `RM`,为什么。
|
|
157
|
+
7. 只冻结 1-3 个阶段。每个阶段都必须有 goal、why now、dependencies、exit signal、kill signal、non-goals。
|
|
158
|
+
8. 把 `RM` 之间的硬依赖压成显式 dependency graph,并标出 parallel-ready wave;不要把“最好按这个顺序做”伪装成 blocker。
|
|
159
|
+
9. backlog 只保留会真的进入下一轮 `cc-plan` 的事项,每项都要带成功信号、下一决策、`Primary Capability`、`Secondary Capabilities`、`Expected Spec Delta`、`Depends On` 与 `Parallel With`。
|
|
160
|
+
10. 用户没批准,不进入 `cc-plan`。
|
|
139
161
|
|
|
140
162
|
## Route Selection Rule
|
|
141
163
|
|
|
@@ -173,14 +195,24 @@ tool_budget:
|
|
|
173
195
|
8. 当前最大的 adoption、trust、delivery 卡点是什么
|
|
174
196
|
9. 这个 roadmap 成功与失败各自用什么信号判断
|
|
175
197
|
|
|
198
|
+
如果这是 developer-facing / operator-facing roadmap,再补 4 件事:
|
|
199
|
+
|
|
200
|
+
10. 目标开发者 / 操作者是谁
|
|
201
|
+
11. 从第一次接触到第一次成功输出需要多久
|
|
202
|
+
12. 让他们觉得“这东西真的有用”的 magic moment 是什么
|
|
203
|
+
13. install / run / debug / upgrade / handoff 中哪个环节最可能让 adoption 失败
|
|
204
|
+
|
|
176
205
|
## Approval Gates
|
|
177
206
|
|
|
178
207
|
1. 没有 `Context Snapshot`,不准给路线推荐。
|
|
179
|
-
2. 没有
|
|
180
|
-
3. 没有
|
|
181
|
-
4.
|
|
182
|
-
5.
|
|
183
|
-
6.
|
|
208
|
+
2. 没有 planning posture、evidence maturity 和 framing check,不准给路线推荐。
|
|
209
|
+
3. 没有 2-3 条路线对比,不准直接拍脑袋定主线。
|
|
210
|
+
4. 没有 exit signal / kill signal / non-goals,不算阶段冻结。
|
|
211
|
+
5. 没有明确成功信号和下一决策,不准把事项放进 `Ready For Req-Plan`。
|
|
212
|
+
6. developer-facing / operator-facing item 没有 target user、time to first value 或 adoption bottleneck,不准标成 ready。
|
|
213
|
+
7. 没有 `RM dependency graph` 或 parallel-ready wave,不准宣称事项可以并发推进。
|
|
214
|
+
8. 没有独立子系统拆分判断,不准把大而混杂的方向伪装成单一主线。
|
|
215
|
+
9. 没有用户批准,不准把 roadmap item 下放到 `cc-plan`。
|
|
184
216
|
|
|
185
217
|
## Review Loop
|
|
186
218
|
|
|
@@ -192,7 +224,10 @@ tool_budget:
|
|
|
192
224
|
4. Feasibility scan:阶段目标与团队容量、依赖、distribution 约束是否接得上。
|
|
193
225
|
5. Graph scan:`Depends On` 是否只包含硬阻塞,图里有没有环,parallel-ready wave 是否真的共享同一前置。
|
|
194
226
|
6. Spec scan:每个 roadmap item 是否都落到某个 capability,而不是悬空需求。
|
|
195
|
-
7.
|
|
227
|
+
7. Decomposition scan:多个独立子系统是否已拆成阶段 / `RM` 候选,而不是塞进一个含糊阶段。
|
|
228
|
+
8. Handoff scan:第一批 roadmap item 是否已经自然长成可进入 `cc-plan` 的对象。
|
|
229
|
+
9. Evidence maturity scan:问题路由是否匹配 idea / user / paying / infra / recovery 状态,还是拿同一套问题硬套所有项目。
|
|
230
|
+
10. Adoption scan:developer-facing / operator-facing item 是否写清目标人、time to first value、magic moment 和 adoption bottleneck。
|
|
196
231
|
|
|
197
232
|
## Output
|
|
198
233
|
|
|
@@ -19,8 +19,18 @@
|
|
|
19
19
|
|
|
20
20
|
- Serial spine:
|
|
21
21
|
- Parallel-ready next wave:
|
|
22
|
+
- Decomposition notes:
|
|
22
23
|
- Notes on blockers:
|
|
23
24
|
|
|
25
|
+
## Adoption Handoff
|
|
26
|
+
|
|
27
|
+
- Planning posture:
|
|
28
|
+
- Evidence maturity:
|
|
29
|
+
- Target developer / operator:
|
|
30
|
+
- Time to first value:
|
|
31
|
+
- Magic moment:
|
|
32
|
+
- Adoption bottleneck:
|
|
33
|
+
|
|
24
34
|
## Ready For Req-Plan
|
|
25
35
|
|
|
26
36
|
- RM-001:
|
|
@@ -33,6 +43,11 @@
|
|
|
33
43
|
- Expected spec delta:
|
|
34
44
|
- Open risks:
|
|
35
45
|
- First planning question:
|
|
46
|
+
- Evidence maturity:
|
|
47
|
+
- Target developer / operator:
|
|
48
|
+
- Time to first value:
|
|
49
|
+
- Magic moment:
|
|
50
|
+
- Adoption bottleneck:
|
|
36
51
|
- Required context to load:
|
|
37
52
|
- Depends On:
|
|
38
53
|
- Parallel With:
|
|
@@ -15,17 +15,24 @@
|
|
|
15
15
|
## Context Snapshot
|
|
16
16
|
|
|
17
17
|
- Product / repo:
|
|
18
|
+
- Planning posture:
|
|
18
19
|
- Project stage:
|
|
20
|
+
- Evidence maturity:
|
|
19
21
|
- Users:
|
|
20
22
|
- Pain:
|
|
21
23
|
- Existing workaround:
|
|
22
24
|
- Strongest demand evidence:
|
|
25
|
+
- Framing check:
|
|
23
26
|
- Why now:
|
|
24
27
|
- Distribution path:
|
|
25
28
|
- Deadline / forcing function:
|
|
26
29
|
- Team / capacity:
|
|
27
30
|
- Hard constraints:
|
|
28
31
|
- Adoption / trust bottleneck:
|
|
32
|
+
- Target developer / operator:
|
|
33
|
+
- Time to first value:
|
|
34
|
+
- Magic moment:
|
|
35
|
+
- Install / run / debug / upgrade bottleneck:
|
|
29
36
|
- Known unknowns:
|
|
30
37
|
- Relevant capabilities:
|
|
31
38
|
|
|
@@ -45,6 +52,7 @@
|
|
|
45
52
|
| wedge-first | | | Recommended / Rejected |
|
|
46
53
|
| platform-first | | | Rejected |
|
|
47
54
|
| rescue-first | | | Rejected |
|
|
55
|
+
| decompose-first | | | Recommended / Rejected |
|
|
48
56
|
|
|
49
57
|
## Recommended Route
|
|
50
58
|
|
|
@@ -64,6 +72,33 @@
|
|
|
64
72
|
- What we refuse to build yet:
|
|
65
73
|
- 6-12 month pull:
|
|
66
74
|
|
|
75
|
+
## Evidence-Maturity Routing
|
|
76
|
+
|
|
77
|
+
- Planning posture:
|
|
78
|
+
- Evidence maturity:
|
|
79
|
+
- Questions selected:
|
|
80
|
+
- Questions intentionally skipped:
|
|
81
|
+
- Reason this route matches maturity:
|
|
82
|
+
- Evidence that would change the route:
|
|
83
|
+
|
|
84
|
+
## DX / Operator Adoption Context
|
|
85
|
+
|
|
86
|
+
- Applies: Yes / No
|
|
87
|
+
- Target developer / operator:
|
|
88
|
+
- Current first-success path:
|
|
89
|
+
- Target time to first value:
|
|
90
|
+
- Magic moment:
|
|
91
|
+
- Install / run / debug / upgrade risks:
|
|
92
|
+
- Adoption bottleneck:
|
|
93
|
+
|
|
94
|
+
## Subsystem Decomposition
|
|
95
|
+
|
|
96
|
+
| Subsystem / RM candidate | User value | Can ship independently? | Merge / split decision | Reason |
|
|
97
|
+
|--------------------------|------------|-------------------------|------------------------|--------|
|
|
98
|
+
| RM-001 | | Yes / No | Merge / Split | |
|
|
99
|
+
|
|
100
|
+
> 如果一个目标里塞了多个独立子系统,先拆阶段和 `RM`,再谈优先级。不要把大杂烩写成一个阶段。
|
|
101
|
+
|
|
67
102
|
## Stage Overview
|
|
68
103
|
|
|
69
104
|
| Stage | Goal | Why now | Primary capabilities | Dependencies | Exit signal | Kill signal | Non-goals |
|
|
@@ -140,6 +175,8 @@ flowchart LR
|
|
|
140
175
|
|
|
141
176
|
- Rejected path A:
|
|
142
177
|
- Rejected path B:
|
|
178
|
+
- Rejected maturity route:
|
|
179
|
+
- Developer / operator adoption assumptions:
|
|
143
180
|
- Open assumptions to verify next:
|
|
144
181
|
- What changed in this version:
|
|
145
182
|
|
|
@@ -6,12 +6,13 @@
|
|
|
6
6
|
"lastSyncedAt": "2026-04-19",
|
|
7
7
|
"backlogMeta": {
|
|
8
8
|
"roadmapVersion": "roadmap.v1",
|
|
9
|
-
"skillVersion": "4.3.
|
|
9
|
+
"skillVersion": "4.3.4",
|
|
10
10
|
"currentFocusStage": "Stage 1"
|
|
11
11
|
},
|
|
12
12
|
"dependencyHandoff": {
|
|
13
13
|
"serialSpine": "RM-001",
|
|
14
14
|
"parallelReadyNextWave": "-",
|
|
15
|
+
"decompositionNotes": "-",
|
|
15
16
|
"notesOnBlockers": "-"
|
|
16
17
|
},
|
|
17
18
|
"items": [
|
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
# CC-Simplify Skill Changelog
|
|
2
2
|
|
|
3
|
+
## v1.3.0 - 2026-04-28
|
|
4
|
+
|
|
5
|
+
- add scope-aware Codex reviewer dispatch with small-diff skip rules and conditional security, API contract, release, frontend performance, and red-team facets
|
|
6
|
+
- require reviewer agents to emit JSONL findings with confidence, evidence, fingerprint, specialist, and optional test stubs
|
|
7
|
+
- add finding deduplication, multi-specialist confidence boost, confidence gates, and a Fix-First auto-fix vs ask/reroute decision table
|
|
8
|
+
- expand testing smell coverage for negative paths, edge cases, isolation, flaky tests, and security enforcement tests
|
|
9
|
+
- add false-positive suppressions and a "new diff smells only" boundary so cleanup does not become historical debt sweeping
|
|
10
|
+
|
|
11
|
+
## v1.2.0 - 2026-04-28
|
|
12
|
+
|
|
13
|
+
- translate the skill body into Chinese and remove the non-Codex `${AGENT_TOOL_NAME}` placeholder
|
|
14
|
+
- define a Codex-native simplification workflow that can use read-only reviewer agents for spec/scope, reuse/structure, and quality/efficiency/test findings
|
|
15
|
+
- require findings to be verified against code, usage, requirements, and fresh validation evidence before any cleanup edit is made
|
|
16
|
+
- add explicit YAGNI, test-anti-pattern, reroute, and cc-check return rules for cleanup changes
|
|
17
|
+
|
|
3
18
|
## v1.1.0 - 2026-04-19
|
|
4
19
|
|
|
5
20
|
- expand `cc-simplify` review scope to catch spec drift alongside reuse, quality, and efficiency issues
|