dev-playbooks-cn 2.6.2 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.0] - 2026-01-26
+
+### Added
+
+- **AI 原生工作流与协议升级**：
+  - 补齐 Start/Router 入口与阶段路由规范
+  - 新增变更包模板与协议合同（RUNBOOK、验证/合规/回滚、Knife Plan、合同 schema）
+  - 完整化质量闸门与证据结构（G0–G6、风险与审计要求）
+  - 新增依赖审计脚本与发布校验入口
+  - 更新架构/文件系统视图与工作流示意图模板
+
+### Changed
+
+- **CLI 入口补齐**：
+  - 新增 `start` 与 `router` 命令，用于入口指引（不执行 AI）
+  - 帮助信息指向模板与工作流文档入口
+
+---
+
 ## [2.6.0] - 2026-01-25
 
 ### Added

package/README.md

@@ -19,6 +19,12 @@
 
 这个 skill 会自动编排完整的开发闭环：Proposal → Design → Spec → Plan → Test → Implement → Review → Archive
 
+不确定入口时，也可以先运行：
+
+```bash
+/devbooks:start
+```
+
 **适用场景**：新功能开发、重大重构、不熟悉 DevBooks 工作流
 
 ---

package/bin/devbooks.js

@@ -9,6 +9,8 @@
  *   dev-playbooks-cn init [path] [options]
  *   dev-playbooks-cn update [path]           # 更新 CLI 和已配置的工具
  *   dev-playbooks-cn migrate --from <framework> [options]
+ *   dev-playbooks-cn start [options]         # 入口指引（不执行 AI）
+ *   dev-playbooks-cn router [options]        # 路由与阶段判断（不执行 AI）
  *
  * 选项：
  *   --tools <tools>    非交互式指定 AI 工具：all, none, 或逗号分隔的列表
@@ -32,6 +34,12 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 const CLI_COMMAND = 'dev-playbooks-cn';
+const ENTRY_DOC = 'docs/ai-native-workflow.md';
+const ENTRY_TEMPLATES = {
+  start: 'templates/claude-commands/devbooks/start.md',
+  router: 'templates/claude-commands/devbooks/router.md',
+  index: 'templates/claude-commands/devbooks/index.md'
+};
 const XDG_CONFIG_HOME = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
 
 // 版本检查缓存配置
@@ -1842,6 +1850,48 @@ async function migrateCommand(projectDir, options) {
 // 帮助信息
 // ============================================================================
 
+function showStartHelp() {
+  console.log();
+  console.log(chalk.bold('DevBooks Start') + ' - 默认入口与阶段指引');
+  console.log();
+  console.log(chalk.cyan('用法:'));
+  console.log(`  ${CLI_COMMAND} start [options]`);
+  console.log();
+  console.log(chalk.cyan('说明:'));
+  console.log('  本命令仅提供入口指引，不执行 AI 或调用 Skills。');
+  console.log('  不确定下一步时，先用 Start 获取路由建议。');
+  console.log();
+  console.log(chalk.cyan('入口模板:'));
+  console.log(`  ${ENTRY_TEMPLATES.start}`);
+  console.log();
+  console.log(chalk.cyan('入口文档:'));
+  console.log(`  ${ENTRY_DOC}`);
+  console.log();
+  console.log(chalk.cyan('相关命令:'));
+  console.log(`  ${CLI_COMMAND} router --help`);
+}
+
+function showRouterHelp() {
+  console.log();
+  console.log(chalk.bold('DevBooks Router') + ' - 路由与阶段判断');
+  console.log();
+  console.log(chalk.cyan('用法:'));
+  console.log(`  ${CLI_COMMAND} router [options]`);
+  console.log();
+  console.log(chalk.cyan('说明:'));
+  console.log('  本命令仅提供路由指引，不执行 AI 或调用 Skills。');
+  console.log('  需要阶段判断与最短闭环路径时使用 Router。');
+  console.log();
+  console.log(chalk.cyan('入口模板:'));
+  console.log(`  ${ENTRY_TEMPLATES.router}`);
+  console.log();
+  console.log(chalk.cyan('入口文档:'));
+  console.log(`  ${ENTRY_DOC}`);
+  console.log();
+  console.log(chalk.cyan('相关命令:'));
+  console.log(`  ${CLI_COMMAND} start --help`);
+}
+
 function showHelp() {
   console.log();
   console.log(chalk.bold('DevBooks') + ' - AI-agnostic spec-driven development workflow');
@@ -1850,6 +1900,8 @@ function showHelp() {
   console.log(`  ${CLI_COMMAND} init [path] [options]              初始化 DevBooks`);
   console.log(`  ${CLI_COMMAND} update [path]                      更新 CLI 和已配置的工具`);
   console.log(`  ${CLI_COMMAND} migrate --from <framework> [opts]  从其他框架迁移`);
+  console.log(`  ${CLI_COMMAND} start [options]                   入口指引（不执行 AI）`);
+  console.log(`  ${CLI_COMMAND} router [options]                  路由与阶段判断（不执行 AI）`);
   console.log();
   console.log(chalk.cyan('选项:'));
   console.log('  --tools <tools>    非交互式指定 AI 工具');
@@ -1863,6 +1915,11 @@ function showHelp() {
   console.log('  -h, --help         显示此帮助信息');
   console.log('  -v, --version      显示版本号');
   console.log();
+  console.log(chalk.cyan('入口模板与文档:'));
+  console.log(`  Start 模板:  ${ENTRY_TEMPLATES.start}`);
+  console.log(`  Router 模板: ${ENTRY_TEMPLATES.router}`);
+  console.log(`  文档入口:    ${ENTRY_DOC}`);
+  console.log();
   console.log(chalk.cyan('支持的 AI 工具:'));
 
   // 按 Skills 支持级别分组显示
@@ -1906,26 +1963,35 @@ function showHelp() {
   console.log(`  ${CLI_COMMAND} migrate --from openspec     # 从 OpenSpec 迁移`);
   console.log(`  ${CLI_COMMAND} migrate --from speckit      # 从 spec-kit 迁移`);
   console.log(`  ${CLI_COMMAND} migrate --from openspec --dry-run  # 模拟迁移`);
+  console.log(`  ${CLI_COMMAND} start                       # 查看默认入口指引`);
+  console.log(`  ${CLI_COMMAND} router                      # 查看路由与阶段判断`);
 }
 
 // ============================================================================
 // 主入口
 // ============================================================================
 
+async function startCommand() {
+  showStartHelp();
+}
+
+async function routerCommand() {
+  showRouterHelp();
+}
+
 async function main() {
   const args = process.argv.slice(2);
 
   // 解析参数
   let command = null;
   let projectPath = null;
-  const options = {};
+  const options = { help: false };
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
 
     if (arg === '-h' || arg === '--help') {
-      showHelp();
-      process.exit(0);
+      options.help = true;
     } else if (arg === '-v' || arg === '--version') {
       showVersion();
       process.exit(0);
@@ -1955,12 +2021,28 @@ async function main() {
 
   // 执行命令
   try {
+    if (options.help) {
+      if (command === 'start') {
+        showStartHelp();
+        return;
+      }
+      if (command === 'router') {
+        showRouterHelp();
+        return;
+      }
+      showHelp();
+      return;
+    }
     if (command === 'init' || !command) {
       await initCommand(projectDir, options);
     } else if (command === 'update') {
       await updateCommand(projectDir);
     } else if (command === 'migrate') {
       await migrateCommand(projectDir, options);
+    } else if (command === 'start') {
+      await startCommand();
+    } else if (command === 'router') {
+      await routerCommand();
     } else {
       console.log(chalk.red(`未知命令: ${command}`));
       showHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-playbooks-cn",
-  "version": "2.6.2",
+  "version": "3.0.0",
   "description": "AI-driven spec-based development workflow",
   "keywords": [
     "devbooks",
@@ -31,9 +31,7 @@
     "bin/",
     "templates/",
     "skills/",
-    "scripts/",
-    ".factory/",
-    ".cursor/"
+    "scripts/"
   ],
   "engines": {
     "node": ">=18"

package/scripts/dependency-audit.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: dependency-audit.sh [options]
+
+Description:
+  Run a dependency audit and write a log for evidence review.
+
+Options:
+  --project-root DIR  Project root directory (default: current dir)
+  --output FILE       Output log file path (default: dependency-audit.log)
+  -h, --help          Show this help message
+
+Examples:
+  dependency-audit.sh --output evidence/audit/dependency-audit.log
+USAGE
+}
+
+project_root="$(pwd)"
+output_file="dependency-audit.log"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --project-root)
+      project_root="${2:-}"
+      shift 2
+      ;;
+    --output)
+      output_file="${2:-}"
+      shift 2
+      ;;
+    *)
+      echo "ERROR: unknown option: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+ done
+
+if [[ -z "$project_root" || -z "$output_file" ]]; then
+  echo "ERROR: project root and output file are required" >&2
+  exit 2
+fi
+
+pkg_file="${project_root}/package.json"
+lock_file="${project_root}/package-lock.json"
+
+if [[ ! -f "$pkg_file" ]]; then
+  echo "ERROR: package.json not found at ${pkg_file}" >&2
+  exit 1
+fi
+
+mkdir -p "$(dirname "$output_file")"
+
+{
+  echo "Dependency Audit"
+  echo "run_at: $(date +%Y-%m-%dT%H:%M:%S%z)"
+  echo "project_root: ${project_root}"
+  echo "package.json: ${pkg_file}"
+  if [[ -f "$lock_file" ]]; then
+    echo "package-lock.json: ${lock_file}"
+  else
+    echo "package-lock.json: missing"
+  fi
+  echo ""
+} >"$output_file"
+
+status=0
+
+if command -v npm >/dev/null 2>&1; then
+  temp_output="$(mktemp)"
+  if npm --prefix "$project_root" audit --json >"$temp_output" 2>/dev/null; then
+    echo "npm_audit: ok" >>"$output_file"
+    echo "summary: no audit errors" >>"$output_file"
+  else
+    status=1
+    echo "npm_audit: failed" >>"$output_file"
+    echo "summary: audit reported issues or failed" >>"$output_file"
+  fi
+  echo "" >>"$output_file"
+  echo "raw_audit_json:" >>"$output_file"
+  cat "$temp_output" >>"$output_file"
+  rm -f "$temp_output"
+else
+  status=1
+  echo "npm_audit: skipped (npm not found)" >>"$output_file"
+  echo "summary: audit not executed" >>"$output_file"
+fi
+
+exit "$status"

package/skills/devbooks-delivery-workflow/references//344/272/244/344/273/230/351/252/214/346/224/266/345/267/245/344/275/234/346/265/201.md

@@ -163,8 +163,8 @@
 **追溯完整性检查**：
 
 - [ ] 每个 AC 都能追溯到：`AC-xxx → Requirement/Scenario → Test IDs → Evidence`
-- [ ] 没有"孤儿测试"（测试存在但无对应 AC 或设计来源）
-- [ ] 没有"孤儿任务"（任务存在但无对应设计来源）
+- [ ] 没有"孤儿测试"（测试存在但无对应 AC 或设计文档条目）
+- [ ] 没有"孤儿任务"（任务存在但无对应设计文档条目）
 - [ ] 没有"无证据的 DONE"（标记完成但无测试通过或人工签核证据）
 
 **归档前最终检查**：
@@ -207,7 +207,7 @@ change-check.sh <change-id> --mode strict --project-root "$(pwd)" --change-root
 - 将**设计验收点（AC）**逐条映射到：Plan 项 + 验收锚点
 - 发现两类缺口立即处理：
   1. **设计有验收点但无锚点** → 补测试/补静态检查/补 checklist
-  2. **计划有任务但无设计来源** → 选择：降级为 DEFERRED，或升级进设计（ADR）再验收
+  2. **计划有任务但无设计文档条目** → 选择：降级为 DEFERRED，或升级进设计（ADR）再验收
 
 ### Step 4：编写/更新验收锚点（Verification Anchors）
 

package/skills/devbooks-docs-consistency/scripts/completeness-checker.sh

@@ -58,9 +58,9 @@ report_line() {
   local ok="$2"
   local msg="$3"
   if [[ "$ok" == "1" ]]; then
-    printf "- %s: ✓ %s\n" "$name" "$msg"
+    printf -- "- %s: ✓ %s\n" "$name" "$msg"
   else
-    printf "- %s: ✗ %s\n" "$name" "$msg"
+    printf -- "- %s: ✗ %s\n" "$name" "$msg"
   fi
 }
 

package/skills/devbooks-router/SKILL.md

@@ -29,6 +29,7 @@ allowed-tools:
 - 先做配置发现（优先读取 `.devbooks/config.yaml`）与规则文档读取，再进入路由判断。
 - 输出 2 个最小关键问题 + 3–6 条路由结果（含路径与理由）。
 - 用户要求“直接开始产出”时，切换到目标 Skill 的输出模式。
+- Start 为默认入口，使用 Router 输出阶段建议与路径。
 
 ## 参考资料
 - `skills/devbooks-router/references/路由规则与模板.md`：入口定位、配置发现、Impact 画像、路由规则、原型模式与上下文检测。

package/skills/devbooks-router/references//350/267/257/347/224/261/350/247/204/345/210/231/344/270/216/346/250/241/346/235/277.md

@@ -57,6 +57,18 @@
 3) 下一步该用哪个（或哪些）`devbooks-*` Skills
 4) 每个产物应落到哪个文件路径
 
+## Start 入口规则
+
+Start 是默认入口，触发时按以下规则输出：
+
+1) 如果 `<change-id>` 不明确，先询问 `<change-id>` 与 `<truth-root>/<change-root>`。
+2) 如果可读取变更包状态（如 `pending/in_progress/review/completed`），按状态给出推荐入口：
+   - pending → proposal
+   - in_progress → design/spec/plan（按缺失产物建议）
+   - review → review
+   - completed → archive
+3) 保持路由输出 3–6 条，包含 Skill + 路径 + 理由。
+
 ## 输出要求（强制）
 
 1) 先问清楚 2 个最小关键问题（若上下文里已有答案则不问）：

package/templates/claude-commands/devbooks/backport.md

@@ -1,10 +1,10 @@
 ---
-skill: devbooks-design-backport
+skill: devbooks-design-doc
 ---
 
 # DevBooks: 设计回写
 
-使用 devbooks-design-backport 把实现过程中发现的新约束/冲突/缺口回写到 design.md。
+使用 devbooks-design-doc 把实现过程中发现的新约束/冲突/缺口回写到 design.md。
 
 ## 用法
 

package/templates/claude-commands/devbooks/c4.md

@@ -1,10 +1,10 @@
 ---
-skill: devbooks-c4-map
+skill: devbooks-design-doc
 ---
 
 # DevBooks: C4 架构地图
 
-使用 devbooks-c4-map 维护 C4 架构文档。
+使用 devbooks-design-doc 产出或更新架构影响（包含 C4 视图要点）。
 
 ## 用法
 
@@ -16,7 +16,6 @@ $ARGUMENTS
 
 ## 说明
 
-自动检测模式（新增 delta/更新真理）：
-- 维护架构层级（Context/Container/Component/Code）
-- 更新 Fitness Tests
-- 同步架构守护规则
+- 输出架构影响与 C4 Delta（如适用）：
+  - 维护架构层级（Context/Container/Component/Code）
+  - 同步架构约束与守门规则（如有变更）

package/templates/claude-commands/devbooks/debate.md

@@ -1,10 +1,14 @@
 ---
-skill: devbooks-proposal-debate-workflow
+skill: multi-skill-combo
+skills:
+  - devbooks-proposal-author
+  - devbooks-proposal-challenger
+  - devbooks-proposal-judge
 ---
 
-# DevBooks: 提案辩论
+# DevBooks: 提案辩论（向后兼容）
 
-使用 devbooks-proposal-debate-workflow 执行完整的提案辩论流程。
+编排 Author → Challenger → Judge 的完整辩论流程。
 
 ## 用法
 
@@ -16,7 +20,9 @@ $ARGUMENTS
 
 ## 说明
 
-编排 Author → Challenger → Judge 的完整辩论流程：
-- 自动协调多角色交互
-- 记录辩论过程
-- 产出最终裁决
+这是一个向后兼容命令，触发多 Skill 组合。
+
+也可使用更精确的直达命令：
+- /devbooks:proposal
+- /devbooks:challenger
+- /devbooks:judge

package/templates/claude-commands/devbooks/federation.md

@@ -1,10 +1,10 @@
 ---
-skill: devbooks-federation
+skill: devbooks-impact-analysis
 ---
 
 # DevBooks: 联邦分析
 
-使用 devbooks-federation 进行跨仓库依赖分析。
+使用 devbooks-impact-analysis 进行跨仓库影响与依赖分析。
 
 ## 用法
 
@@ -19,4 +19,4 @@ $ARGUMENTS
 分析多仓库之间的依赖关系：
 - 识别跨仓库影响
 - 协调版本兼容性
-- 生成联邦依赖图
+- 记录兼容性与风险提示

package/templates/claude-commands/devbooks/index.md

@@ -1,10 +1,10 @@
 ---
-skill: devbooks-index-bootstrap
+skill: devbooks-router
 ---
 
-# DevBooks: 索引初始化
+# DevBooks: 命令索引
 
-使用 devbooks-index-bootstrap 初始化代码索引。
+DevBooks 常用命令索引入口。
 
 ## 用法
 
@@ -16,7 +16,6 @@ $ARGUMENTS
 
 ## 说明
 
-为项目建立代码索引：
-- 生成 SCIP 索引
-- 配置符号导航
-- 启用代码智能功能
+- 默认入口：/devbooks:start
+- 路由与阶段判断：/devbooks:router
+- 完整闭环：/devbooks:delivery

package/templates/claude-commands/devbooks/quick.md

@@ -1,10 +1,10 @@
 ---
-skill: quick-mode
+skill: devbooks-router
 ---
 
 # DevBooks: 快速模式（向后兼容）
 
-触发快速模式，适用于小型变更（5 文件以内）。
+快速入口，适用于小型变更（5 文件以内），由 Router 输出最短闭环路径。
 
 ## 用法
 
@@ -17,8 +17,7 @@ $ARGUMENTS
 ## 说明
 
 这是一个向后兼容命令，适用于简单变更场景：
-- 跳过完整的 proposal/design 流程
-- 直接进入实现阶段
+- 由 Router 判断是否可走轻量路径
 - 适用于 bug 修复、小功能、文档更新等
 
 对于复杂变更（>5 文件或跨模块），建议使用 /devbooks:router 获取完整执行计划。

package/templates/claude-commands/devbooks/router.md

@@ -21,4 +21,4 @@ Router 是 DevBooks 工作流的主入口，适用于复杂变更（>5文件或
 - 检测项目当前状态
 - 推荐下一步 Skill
 
-对于已知具体要执行的 Skill，可直接使用对应的直达命令。
+对于已知具体要执行的 Skill，可直接使用对应的直达命令；不确定时优先使用 /devbooks:start。

package/templates/claude-commands/devbooks/start.md

@@ -0,0 +1,21 @@
+---
+skill: devbooks-router
+---
+
+# DevBooks: Start
+
+Start 是默认入口，用于判定当前阶段并给出下一步路由建议。
+
+## 用法
+
+/devbooks:start [参数]
+
+## 参数
+
+$ARGUMENTS
+
+## 说明
+
+- 当不确定下一步时，从 Start 进入。
+- Router 会读取配置映射与现有产物，给出最短闭环路径。
+- 如果已知 change-id，可在参数中提供以减少询问。

package/templates/dev-playbooks/changes/RUNBOOK.md

@@ -0,0 +1,34 @@
+# RUNBOOK
+
+## 目标与范围
+
+- 目标：<goal>
+- 范围：<scope>
+
+## 前置条件
+
+- 依赖：<dependencies>
+- 假设：<assumptions>
+
+## 执行清单
+
+| 步骤 | 责任角色 | 说明 |
+| --- | --- | --- |
+| 1 | owner | <step> |
+
+## 验证锚点
+
+- 入口：<command>
+- 成功标准：<criteria>
+
+## 回滚计划
+
+- 回滚触发：<trigger>
+- 回滚步骤：<steps>
+
+## 证据落点
+
+- red-baseline: `evidence/red-baseline/`
+- green-final: `evidence/green-final/`
+- gates: `evidence/gates/`
+- risks: `evidence/risks/`

package/templates/dev-playbooks/changes/brief.md

@@ -0,0 +1,14 @@
+# brief
+
+## 背景
+
+- <background>
+
+## 目标
+
+- <goal>
+
+## 范围
+
+- in: <in-scope>
+- out: <out-scope>

package/templates/dev-playbooks/changes/compliance.md

@@ -0,0 +1,9 @@
+# compliance
+
+## 合规要求
+
+- <requirement>
+
+## 证据
+
+- <evidence>

package/templates/dev-playbooks/changes/inputs/index.md

@@ -0,0 +1,8 @@
+# inputs
+
+## 输入清单
+
+- design.md
+- tasks.md
+- specs/**
+- verification.md

package/templates/dev-playbooks/changes/proposal.md

@@ -0,0 +1,40 @@
+# proposal
+
+## 元信息
+
+| 字段 | 值 |
+| --- | --- |
+| change_id | <change-id> |
+| intervention_level | <level> |
+| change_type | <change-type> |
+| risk_level | <risk-level> |
+| state | pending |
+| state_reason | <reason-if-needed> |
+| next_action | <next-action> |
+| epic_id | <epic-id> |
+| slice_id | <slice-id> |
+| ac_ids | [AC-001] |
+| acceptance_ids | [ACC-001] |
+| truth_refs | [] |
+| risk_flags | [] |
+| required_gates | [G0, G1] |
+| approvals | [] |
+| escape_hatch | <optional> |
+
+## Why
+
+- <why>
+
+## What
+
+- <what>
+
+## Impact
+
+- <impact>
+
+## Debate Packet
+
+- 选项 A：<option-a>
+- 选项 B：<option-b>
+- 决策点：<decision>

package/templates/dev-playbooks/changes/prototype/README.md

@@ -0,0 +1,8 @@
+# Prototype
+
+本目录用于快速验证原型，不得直接进入真理源。
+
+## 规则
+
+- 所有原型必须标注目的与范围
+- 通过验证后再进入正式变更包流程

package/templates/dev-playbooks/changes/rollback-plan.md

@@ -0,0 +1,15 @@
+# rollback-plan
+
+## 回滚触发条件
+
+- <trigger>
+
+## 回滚步骤
+
+| 步骤 | 说明 |
+| --- | --- |
+| 1 | <step> |
+
+## 回滚验证
+
+- <verification>

package/templates/dev-playbooks/changes/validation.md

@@ -0,0 +1,11 @@
+# validation
+
+## 验证计划
+
+| 项目 | 方式 | 通过标准 |
+| --- | --- | --- |
+| 测试 | <command> | 全部通过 |
+
+## 结果记录
+
+- <result>

package/templates/dev-playbooks/changes/verification.md

@@ -0,0 +1,17 @@
+# verification
+
+## 追溯矩阵
+
+| AC-ID | Spec | Tests | Evidence |
+| --- | --- | --- | --- |
+| AC-001 | <spec> | <test> | <evidence> |
+
+## Gate 状态
+
+| Gate | 状态 | 证据 |
+| --- | --- | --- |
+| G0 | pending | <evidence> |
+
+## 备注
+
+- <notes>

package/templates/dev-playbooks/specs/bootstrap/README.md

@@ -0,0 +1,24 @@
+# Bootstrap 规格说明模板
+
+本模板用于存量项目初始化时的基线工件说明与落盘清单。
+
+## 最小工件集
+
+- 项目画像
+- 术语表
+- 关键概念
+- 基线规格
+- 最小验证锚点
+
+## DoR（Definition of Ready）
+
+| 条件 | 判定 | 处理策略 |
+| --- | --- | --- |
+| 基线工件齐备 | 必须满足 | 未满足则触发补齐 |
+| 变更范围明确 | 必须满足 | 未满足则返回澄清 |
+| 风险标记可用 | 必须满足 | 未满足则记录为阻断 |
+
+## 验证锚点
+
+- 产出路径：`dev-playbooks/specs/_meta/`
+- 证据落点：`dev-playbooks/changes/<change-id>/evidence/`

package/templates/dev-playbooks/specs/knife/knife-plan.md

@@ -0,0 +1,21 @@
+# Knife Plan 模板
+
+> 用于切片计划的机读合同与验证锚点清单。
+
+## 元信息
+
+- plan_id: <plan-id>
+- epic_id: <epic-id>
+- slice_id: <slice-id>
+- ac_ids: [AC-001]
+- acceptance_ids: [ACC-001]
+- change_type: feature
+- risk_level: medium
+- dependencies: []
+- assumptions: <assumptions>
+
+## 验证锚点
+
+| anchor_id | gate_id | evidence_type | success_criteria | owner |
+| --- | --- | --- | --- | --- |
+| ANCHOR-001 | G3 | checklist | 验证锚点字段齐备 | planner |