spec-canon 0.1.6 → 0.1.8

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.6",
+  "version": "0.1.8",
   "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

@@ -45,6 +45,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 +60,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/daily/step1_requirement.md

@@ -1,5 +1,6 @@
 若存在 @spec-canon/changes/{{CHANGE}}/00_context.md，请先阅读；否则跳过。
 阅读以下 change goal，生成 spec-canon/changes/{{CHANGE}}/01_requirement.md。
+按 @spec-canon/templates/01_requirement.md 模板生成文档。
 要求：
 1. AC 至少覆盖主流程 + 幂等 + 2 个失败场景
 2. §3 Scope：若已有 00_context.md，基于其 §2 标注本次变更涉及的模块/文件；否则基于代码库自行分析

package/templates/prompts/daily/step2_implementation.md

@@ -1,7 +1,8 @@
 请阅读 @spec-canon/changes/{{CHANGE}}/ 下的 00_context.md + 01_requirement.md + 02_interface.md，
 生成 03_implementation.md。
+按 @spec-canon/templates/03_implementation.md 模板生成文档。
 §2 Design Decision：参考 00_context.md §4 历史决策，评估技术方案。
 如果有明确最优方案，直接选定并说明理由；
 如果存在多个可行方案，使用 AskUserQuestion 向我确认后再继续。
 File Changes 基于 00_context.md §2，Core Logic 规避 00_context.md §5 已知坑位。
-每个 Step 必须有验证命令。
+每个 Step 必须有验证命令。

package/templates/prompts/daily/step2_interface.md

@@ -1,6 +1,7 @@
 请阅读 @spec-canon/changes/{{CHANGE}}/ 下的 00_context.md + 01_requirement.md，
 并扫描代码库中的真实接口入口（优先看 `Controller` / `Router` / `Handler` / 路由定义；若项目已有 OpenAPI 或接口 DTO，也一并参考），
 生成 02_interface.md。
+按 @spec-canon/templates/02_interface.md 模板生成文档。
 
 要求：
 1. 先用 00_context.md §2.3 快速定位相关已有接口，再回看真实代码入口确认路径、HTTP 方法、参数组织、请求/响应结构、鉴权方式、错误响应风格和 DTO 命名

package/templates/prompts/daily/step2_test_spec.md

@@ -1,4 +1,5 @@
 请阅读 @spec-canon/changes/{{CHANGE}}/ 下的全部 Spec，
 生成 04_test_spec.md。
+按 @spec-canon/templates/04_test_spec.md 模板生成文档。
 Regression Impact 基于 00_context.md §2 的模块关系推导，
-边界用例参考 00_context.md §5 的已知坑位。
+边界用例参考 00_context.md §5 的已知坑位。

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` | 分步编码 | 逐步确认 |