spec-canon 0.1.7 → 0.1.9

package/README.md

@@ -66,7 +66,7 @@ npx spec-canon --help
 → 阅读 [guide/04_new_project_sop.md](docs/guide/04_new_project_sop.md)，然后使用 `spec-canon prompt guide` 查看决策树
 
 ### 我要在已有项目中开发新需求
-→ 先运行 `spec-canon change start --goal ...` 建立 active change，再用 `spec-canon change next` 查看当前候选步骤
+→ 先运行 `spec-canon change start --goal ...` 建立 active change（待命名状态），运行 `ctx` 后 AI 会建议 change 名，再用 `change start -g <goal> -c <name>` 确认命名；然后用 `spec-canon change next` 查看候选步骤
 
 ### 我要为已有项目引入 SDD
 → 阅读 [guide/05_iterative_project_sop.md](docs/guide/05_iterative_project_sop.md) 的冷启动策略，然后使用 `spec-canon prompt list --stage iterative`

package/dist/index.js

@@ -1,9 +1,11 @@
 import { Command } from 'commander';
+import updateNotifier from 'update-notifier';
 import { registerChangeCommand } from './commands/change.js';
 import { registerInitCommand } from './commands/init.js';
 import { registerPromptCommand } from './commands/prompt.js';
 import { registerSyncCommand } from './commands/sync.js';
 import { CLI_VERSION } from './version.js';
+updateNotifier({ pkg: { name: 'spec-canon', version: CLI_VERSION } }).notify();
 const program = new Command();
 program
     .name('spec-canon')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-canon",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "CLI toolkit for Spec-Driven Development (SDD)",
   "type": "module",
   "license": "MIT",
@@ -30,6 +30,7 @@
     "dev": "tsx src/index.ts",
     "test": "vitest run",
     "preversion": "npm test",
+    "version": "node scripts/sync-site-version.mjs",
     "prepublishOnly": "npm run build"
   },
   "files": [
@@ -41,10 +42,12 @@
     "node": ">=20"
   },
   "dependencies": {
-    "commander": "^13.0.0"
+    "commander": "^13.0.0",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "@types/update-notifier": "^6.0.8",
     "tsx": "^4.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.0.18"

package/templates/claude-md-section.md

@@ -35,7 +35,10 @@ Change Spec 生成顺序（后者依赖前者作为上下文）：
 | 中等需求 | `01` + `02_interface` + `AI_CHANGELOG` | 回填接口 + 业务规则 |
 | 复杂需求 | 完整 `00`→`01`→`02`→`03`→`04` + `AI_CHANGELOG` | 完整回填 + 检查跨域依赖 |
 
-裁剪原则：`00_context` 的必要性取决于 AI 是否需要理解系统现状；归档回填的必要性取决于是否产生系统级变更（新接口/新规则/数据模型变更）。
+裁剪三问（逐项判断最小文档集）：
+1. AI 是否需要理解系统现状？→ 是则需要 `00_context`
+2. 是否涉及接口或数据模型变更？→ 是则需要 `02_interface`
+3. 是否产生需要长期保留的系统级知识？→ 是则需要归档回填 `domain_spec`
 
 ### 日常工作流
 
@@ -45,6 +48,7 @@ Change Spec 生成顺序（后者依赖前者作为上下文）：
 |---|---|---|---|
 | Step -1 | `change start --goal` | active change | 确认 goal 描述准确；若未确认 change 名，先接受待命名状态 |
 | Step 0 | `ctx` | `00_context.md` | 审阅系统现状快照，确认 AI 自动识别的域、模块和待补充项 |
+| Step 0.5 | `change start -g <goal> -c <name>` | 确认 change 名 | 采纳或修改 ctx 建议的 change 名 |
 | Step 1 | `req` | `01_requirement.md` | 审阅验收标准，Sign-off |
 | Step 2 | `iface` → `impl-spec` → `test-spec` | `02` / `03` / `04` | 审阅接口设计、文件路径、步骤顺序 |
 | Step 3 | `impl` | 分步编码 | 逐步确认，Gate 验证 |
@@ -59,7 +63,9 @@ domain_spec 生命周期：变更启动时由 AI 从 change goal 出发，结合
 
 ```bash
 spec-canon sync                          # 给已初始化项目安全补齐 SDD 骨架
-spec-canon change start -g @docs/prd.md   # 建立当前 active change
+spec-canon change start -g @docs/prd.md   # 建立当前 active change（待命名）
+# → 运行 ctx 后 AI 建议 change 名
+spec-canon change start -g @docs/prd.md -c feat-001-checkin  # 确认命名
 spec-canon change status                  # 查看当前进度与推荐下一步
 spec-canon change next                    # 查看当前候选 next prompts
 spec-canon change -d /path status         # 指定目标项目目录

package/templates/prompts/guide.md

@@ -22,7 +22,7 @@
 ## 全新项目
 
 1. 运行 `spec-canon init --domain <首个业务域名>` 初始化项目结构
-2. 使用 `change start --goal` 建立 active change
+2. 使用 `change start --goal -c <name>` 建立 active change（新项目跳过 ctx，直接命名）
 3. 可先用 `change next` 查看当前候选步骤
 4. 使用 `req` 生成 01_requirement.md（人工审阅 AC 并 Sign-off）
 5. 依次使用 `iface` → `impl-spec` → `test-spec` → `impl` → `review` 完成首个变更
@@ -39,9 +39,10 @@
 1. 运行 `spec-canon init` 初始化结构
 2. 使用 `change start --goal` 建立 active change
 3. 可先用 `change next` 查看当前候选步骤
-4. 使用 `ctx` 生成 00_context.md，由 AI 自动识别主域、上下游域和关键模块
-5. 按日常流程完成变更（req → iface → impl-spec → test-spec → impl → review）
-6. 在 Archive 步骤使用 `domain-sync` 创建首份 domain_spec（可省略 `-d` 自动发现受影响域）
+4. 使用 `ctx` 生成 00_context.md，AI 自动识别主域并建议 change 名
+5. 用 `change start -g <goal> -c <name>` 确认命名
+6. 按日常流程完成变更（req → iface → impl-spec → test-spec → impl → review）
+7. 在 Archive 步骤使用 `domain-sync` 创建首份 domain_spec（可省略 `-d` 自动发现受影响域）
 
 ### 路径 B：专项批量基线
 
@@ -69,6 +70,7 @@
 | Step -1 | `change start --goal` | 建立 active change | 确认 goal 描述准确；若未确认 change 名，先接受待命名状态 |
 | Step -0.5 | `change next` | 查看候选 next prompts | 关注默认宽松模式下保留的 `iface` / `domain-sync` 候选，自己做判断 |
 | Step 0 | `ctx` | 生成 00_context.md | 审阅系统现状快照，确认 AI 自动识别的域、模块和待补充项 |
+| Step 0.5 | `change start -g <goal> -c <name>` | 确认 change 名 | AI 在 ctx 中建议的名称是否准确 |
 | Step 1 | `req` | 生成 01_requirement.md | 审阅 AC，Sign-off |
 | Step 2 | `iface` → `impl-spec` → `test-spec` | 生成 02/03/04 文档 | 审阅文件路径、步骤顺序 |
 | Step 3 | `impl` | 分步编码 | 逐步确认 |