spec-canon 0.1.8 → 0.1.10

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spec-canon",
3
- "version": "0.1.8",
3
+ "version": "0.1.10",
4
4
  "description": "CLI toolkit for Spec-Driven Development (SDD)",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -35,7 +35,12 @@ Change Spec 生成顺序(后者依赖前者作为上下文):
35
35
  | 中等需求 | `01` + `02_interface` + `AI_CHANGELOG` | 回填接口 + 业务规则 |
36
36
  | 复杂需求 | 完整 `00`→`01`→`02`→`03`→`04` + `AI_CHANGELOG` | 完整回填 + 检查跨域依赖 |
37
37
 
38
- 裁剪原则:`00_context` 的必要性取决于 AI 是否需要理解系统现状;归档回填的必要性取决于是否产生系统级变更(新接口/新规则/数据模型变更)。
38
+ > 上表是各规模的默认最小集。实际裁剪以下方三问为准——若 Q1 为"是",小需求 / 中等需求同样应前置 `00_context`。
39
+
40
+ 裁剪三问(逐项判断最小文档集):
41
+ 1. AI 是否需要理解系统现状?→ 是则需要 `00_context`
42
+ 2. 是否涉及接口或数据模型变更?→ 是则需要 `02_interface`
43
+ 3. 是否产生需要长期保留的系统级知识?→ 是则需要归档回填 `domain_spec`
39
44
 
40
45
  ### 日常工作流
41
46
 
@@ -14,8 +14,8 @@
14
14
  └─ SDD 已就绪,日常开发
15
15
  └─ 按任务规模裁剪:
16
16
  ├─ 小 Bugfix ────── 仅更新 AI_CHANGELOG(无需提示词)
17
- ├─ 小需求 ────────── req → impl → review
18
- ├─ 中等需求 ──────── req → iface → impl → review
17
+ ├─ 小需求 ────────── (ctx →) req → impl → review
18
+ ├─ 中等需求 ──────── (ctx →) req → iface → impl → review
19
19
  └─ 复杂需求 ──────── ctx → req → iface → impl-spec → test-spec → impl → review → domain-sync
20
20
  ```
21
21
 
@@ -80,10 +80,12 @@
80
80
  按任务规模裁剪——小任务不必跑完全部步骤:
81
81
 
82
82
  - **小 Bugfix**:仅更新 AI_CHANGELOG(无需提示词)
83
- - **小需求**:`change start` → `req` → `impl`(基于01)→ `review`(基于01)
84
- - **中等需求**:`change start` → `req` → `iface` → `impl`(基于01+02)→ `review`(基于01+02)
83
+ - **小需求**:`change start` → (`ctx` →) `req` → `impl`(基于01)→ `review`(基于01)
84
+ - **中等需求**:`change start` → (`ctx` →) `req` → `iface` → `impl`(基于01+02)→ `review`(基于01+02)
85
85
  - **复杂需求**:完整流程 change start → domain-sync
86
86
 
87
+ > `(ctx →)` 表示可选:若 AI 需要理解系统现状(如涉及陌生模块或跨域依赖),小需求 / 中等需求也应前置 `ctx`。
88
+
87
89
  补充:如果不想手动判断当前该跑哪一步,可在任一阶段执行 `spec-canon change next`。该命令默认输出候选步骤列表,而不是唯一推荐;如确认没有接口变化或无需系统级归档,可用 `--no-contract-change`、`--no-system-change` 收窄。
88
90
 
89
91
  ## 域拆分