dev-playbooks-cn 3.0.0 → 4.0.0

package/CHANGELOG.md

@@ -1,32 +1,130 @@
-# Changelog
+# 变更日志
 
-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).
+格式参考 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)，并遵循 [语义化版本](https://semver.org/spec/v2.0.0.html)。
+
+## [4.0.0] - 2026-02-03
+
+### 新增
+
+- **完成合同（Completion Contract）**：把用户意图编译为机读合同，锁定“义务→检查→证据”链条，防止交付标准被静默弱化
+- **7 道闸门（G0-G6）**：从输入就绪到归档裁决，全链路可裁判检查点，任何一道失败都会阻断
+- **上游 SSOT 支持**：自动索引项目已有的需求文档，提取可裁判约束；缺失时自动创建最小 SSOT 包
+- **Knife 切片协议**：大需求强制切片，每片有复杂度预算，超预算必须再切
+- **Void 研究协议**：高熵问题先研究再决策，产出可追溯的决策记录（ADR）
+- **证据新鲜度校验**：证据文件必须比被覆盖的交付物更新，防止用旧证据糊弄
+- **弱连接义务**：文档、配置、发布说明等“代码外契约”也被编译为可裁判义务
+
+### 修复
+
+- **忽略规则补齐**：补齐 `.ci-index/`（本地索引数据库目录）到忽略清单，避免误提交/误发布
+- **文档示例一致性**：安装后命令示例对齐为 `dev-playbooks-cn`
+
+## [3.1.0] - 2026-01-31
+
+> ⚠️ 重要：`3.0.0` 存在“错误发布/叙事漂移”风险（版本/变更记录与能力集不一致）。本版本用于收敛并提供可复验的发布与同步证据。建议跳过 `3.0.0`，直接使用 `3.1.0`。
+
+### 新增
+
+- **发布边界证据锚点**：
+  - 将 `npm pack --dry-run` 作为发布边界的客观证据（packlist），用于复验“包内包含/不包含”的最终口径
+  - 补齐 CLI 入口一致性自检锚点（bin 映射与入口可执行性）
+
+### 变更
+
+- **版本收敛**：
+  - CN/EN 用户侧版本统一推进到 `3.1.0`，并对齐 Release notes 叙事（语言不同但要点一致）
+
+### 修复
+
+- **发布与同步闭环可裁判性**：
+  - 将“发布包范围”和“跨仓同步边界”从口头约定收敛为脚本可复验证据（packlist + parity 报告）
+
+---
+
+## [3.0.3] - 2026-01-29
+
+### 新增
+
+- **协议 v1.1 覆盖与强制校验**：
+  - 新增 v1.1 coverage mapping，并强制产出覆盖报告（映射 + 证据驱动；要求 `uncovered=0`）
+- **闸门报告与风险证据约定**：
+  - 新增 Gate Report 证据约定与风险证据落点（`evidence/gates/`、`evidence/risks/`）
+- **依赖审计输出格式化**：
+  - 新增格式化的依赖审计输出（最小字段 + 原始 audit JSON）
+
+### 变更
+
+- **强化 `change-check.sh`**：
+  - 加固元数据合同、状态机、change-type 矩阵，以及 Knife/Bootstrap 的闸门校验
+- **对齐文档与模板**：
+  - 对齐 Gate Report、覆盖报告与依赖审计的约定（docs + templates）
+
+---
+
+## [3.0.2] - 2026-01-28
+
+### 新增
+
+- **协议层 CN↔EN 同步工具**：
+  - 新增针对 `dev-playbooks/**` 的协议层同步脚本（带可审计报告与回滚锚点）：`scripts/english-sync-protocol.sh`
+- **v1.1 覆盖报告生成器**：
+  - 新增用于 strict/archive 闸门的 v1.1 覆盖报告生成脚本：`scripts/generate-protocol-v1.1-coverage-report.sh`
+
+### 变更
+
+- **加固 strict/archive 闸门**：
+  - strict/archive 需要协议同步报告、parity 报告与 v1.1 覆盖报告（`skills/devbooks-delivery-workflow/scripts/change-check.sh`）
+- **高风险审批加固**：
+  - strict 模式下 `risk_level=high` 需要有人类审批记录（闸门强制）
+
+---
+
+## [3.0.1] - 2026-01-27
+
+### 新增
+
+- **新增 `/devbooks:delivery`（基于 `devbooks-delivery-workflow`）**：
+  - 统一入口：产物化变更包骨架（RUNBOOK/inputs index + evidence + completion contract）并路由 `request_kind`
+- **新增验证入口**：
+  - 新增 legacy 清理、slash commands、npm 打包与总结校验等验证入口
+- **新增工具脚本**：
+  - `tools/devbooks-embedding.sh`、`tools/devbooks-complexity.sh`、`tools/devbooks-entropy-viz.sh`
+
+### 变更
+
+- **完善 strict 闸门**：
+  - 完成 `change-check.sh` strict 校验：G0–G6 报告、风险/追溯/handoff 阻断，以及 registry 一致性检查
+- **加固 `scripts/english-sync.sh`**：
+  - 增加发布规格报告与加强 `dev-playbooks/**` deny 边界
+- **统一 CLI 入口脚本**：
+  - `bin/devbooks.mjs`
+
+---
 
 ## [3.0.0] - 2026-01-26
 
-### Added
+### 新增
 
 - **AI 原生工作流与协议升级**：
-  - 补齐 Start/Router 入口与阶段路由规范
+  - 补齐 Delivery 入口与 request_kind 路由规范
   - 新增变更包模板与协议合同（RUNBOOK、验证/合规/回滚、Knife Plan、合同 schema）
   - 完整化质量闸门与证据结构（G0–G6、风险与审计要求）
   - 新增依赖审计脚本与发布校验入口
   - 更新架构/文件系统视图与工作流示意图模板
 
-### Changed
+### 变更
 
 - **CLI 入口补齐**：
-  - 新增 `start` 与 `router` 命令，用于入口指引（不执行 AI）
+  - 新增 `delivery` 命令，用于入口指引（不执行 AI）
   - 帮助信息指向模板与工作流文档入口
 
 ---
 
 ## [2.6.0] - 2026-01-25
 
-### Added
+### 新增
 
 - **MCP 增强功能**：
   - 新增 MCP 检测脚本 `scripts/detect-mcp.sh`
@@ -38,13 +136,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - 新增 `skills/devbooks-archiver/references/归档流程与规则.md`
   - 新增 `skills/devbooks-convergence-audit/references/` 目录
   - 新增 `skills/devbooks-delivery-workflow/references/编排禁令与阶段表.md`
-  - 新增 `skills/devbooks-router/references/` 目录
 
 - **规格文档完善**：
   - 新增 `dev-playbooks/specs/README.md` 规格索引
   - 完善 MCP、共享方法论、样式清理等规格文档
 
-### Changed
+### 变更
 
 - **文档结构优化**：
   - 更新所有 skill 的 SKILL.md 文档
@@ -58,13 +155,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.5.4] - 2026-01-23
 
-### Fixed
+### 修复
 
 - **修正 ignore 规则**：
   - 移除 `.ckb/` - 这是外部工具 CKB 的缓存，不属于 DevBooks
   - 将 `dev-playbooks/changes/*/evidence/` 改为 `dev-playbooks/` - 整个工作目录都应该被 ignore
 
-### Changed
+### 变更
 
 - **更准确的 ignore 范围**：
   - `dev-playbooks/` - DevBooks 工作目录（包含所有运行时产生的内容）
@@ -76,7 +173,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.5.3] - 2026-01-23
 
-### Added
+### 新增
 
 - **智能 ignore 功能增强**：
   - 自动识别并 ignore DevBooks 工作流产生的临时文件
@@ -86,7 +183,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - 新增 `.ckb/` - CKB 代码知识库缓存
   - 自动识别项目级 skills 目录（`.factory/`, `.cursor/` 等）
 
-### Changed
+### 变更
 
 - **更智能的 ignore 规则生成**：
   - 根据选择的 AI 工具自动添加对应的目录
@@ -97,7 +194,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.5.2] - 2026-01-23
 
-### Fixed
+### 修复
 
 - **init 命令支持 Factory 和 Cursor**：
   - 将 Factory 添加为完整 Skills 支持的工具
@@ -114,7 +211,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.5.1] - 2026-01-23
 
-### Fixed
+### 修复
 
 - 修复 `dev-playbooks-cn update` 命令的 changelog 显示功能
   - 添加完整的 2.5.0 版本变更记录
@@ -124,7 +221,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.5.0] - 2026-01-23
 
-### Added
+### 新增
 
 - **Factory 原生 Skills 支持**：添加 `.factory/skills/` 目录，支持 Factory Droid
   - 使用符号链接指向现有 `skills/` 目录，保持单一数据源
@@ -136,7 +233,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - 所有 18 个 DevBooks skills 可在 Cursor 中原生使用
   - 符合 Cursor Agent Skills 标准
 
-### Changed
+### 变更
 
 - **README 优化**：
   - 移除"30秒电梯演讲"章节，简化文档结构
@@ -159,7 +256,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.3.0] - 2026-01-23
 
-### Added
+### 新增
 
 - 新增 `devbooks-docs-consistency`：文档一致性检查技能（原 `devbooks-docs-sync` 的改名与增强）
   - 支持自定义规则引擎（持续规则 + 一次性任务）
@@ -174,7 +271,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `scripts/benchmark-scan.sh`：扫描性能基准测试
   - `scripts/detect-fancy-words.sh`：浮夸词语检测
 
-### Changed
+### 变更
 
 - `devbooks-docs-sync` 改名为 `devbooks-docs-consistency`，旧名称作为别名保留（6 个月弃用期）
 - 更新所有 skills 的 AI 行为规范，添加专家角色声明协议
@@ -225,7 +322,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.1.0] - 2025-01-19
 
-### Added
+### 新增
 
 - **Version Changelog Display**: When running `dev-playbooks-cn update`, the CLI now displays a formatted changelog summary showing all changes between the current version and the latest version
   - ✅ Automatic fetch from GitHub: Retrieves CHANGELOG.md from the repository
@@ -242,7 +339,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.0.0] - 2026-01-19
 
-### Added
+### 新增
 
 #### 🎯 Human-Friendly Document Templates
 
@@ -286,7 +383,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Updated README.md with v2.0.0 features section (both Chinese and English versions)
 
-### Changed
+### 变更
 
 - **proposal-author skill**: Updated to use new document templates
   - Now generates documents with "Bottom Line Up Front" section
@@ -382,14 +479,14 @@ New projects will automatically use the new document templates. No migration nee
 
 ## [1.7.4] - 2026-01-18
 
-### Changed
+### 变更
 - Various bug fixes and improvements
 
 ---
 
 ## [1.7.0] - 2026-01-15
 
-### Added
+### 新增
 - Initial release with 18 skills
 - Support for Claude Code, Codex CLI, and other AI tools
 - Quality gates and role isolation

package/README.md

@@ -1,224 +1,172 @@
 # DevBooks
 
-**AI 编程的质量闸门：让 AI 助手从"不可预测"变成"可验证"**
-
 [![npm](https://img.shields.io/npm/v/dev-playbooks-cn)](https://www.npmjs.com/package/dev-playbooks-cn)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-![DevBooks 工作流](docs/workflow-diagram.svg)
-
----
-
-## 最佳实践：一键跑完整闭环
+## v4.0 新特性
 
-不知道怎么用？直接运行：
-
-```bash
-/devbooks-delivery-workflow
-```
-
-这个 skill 会自动编排完整的开发闭环：Proposal → Design → Spec → Plan → Test → Implement → Review → Archive
-
-不确定入口时，也可以先运行：
-
-```bash
-/devbooks:start
-```
-
-**适用场景**：新功能开发、重大重构、不熟悉 DevBooks 工作流
-
----
-
-## 定位与文本规范
-
-DevBooks 本体是非 MCP 工具，但提供 MCP 可选集成点，便于按需接入外部能力，同时保留少量自检脚本作为护栏。
-DevBooks 是一套围绕协议、工作流、文本规范的协作体系，强调可追溯与可验证。
-
-约束：核心流程必须保持可追溯与可审计。
-取舍：更重视一致性检查，接受部分自动化效率降低。
-影响：文档可扫描性提高，协作成本下降。
+- **完成合同（Completion Contract）**：把用户意图编译为机读合同，锁定"义务→检查→证据"链条，防止 AI 偷偷降低交付标准
+- **7 道闸门（G0-G6）**：从输入就绪到归档裁决，全链路可裁判检查点，任何一道失败都会阻断
+- **上游 SSOT 支持**：自动索引项目已有的需求文档，提取可裁判约束；没有需求文档时自动创建最小 SSOT 包
+- **Knife 切片协议**：大需求强制切片，每片有复杂度预算，超预算必须再切
+- **Void 研究协议**：高熵问题先研究再决策，产出可追溯的决策记录（ADR）
+- **证据新鲜度校验**：证据文件必须比被覆盖的交付物更新，防止用旧证据糊弄
+- **弱连接义务**：文档、配置、发布说明等"代码外契约"也被编译为可裁判义务
 
 ---
 
-## 我们解决的核心问题
-
-### 问题 1：逻辑幻觉与事实捏造
+## 你用 AI 写代码时，是不是经常遇到这些问题？
 
-**痛点**：AI 在缺乏知识时倾向于自信地编造代码或库，而非承认无知。
+**"说改好了，结果没改好"**
+AI 说"已修复"，你问它确定吗，它说"确定"。上线后炸了。回头看，它写的测试恰好能通过它自己的 Bug。
 
-**DevBooks 方案**：
-- 规格驱动开发：所有代码必须追溯到 AC-xxx（验收标准）
-- Contract Tests：验证对外契约，防止 API 幻觉
+**"改着改着就忘了之前说的"**
+对话开头你说"不要改 X 模块"，三十轮对话后它把 X 模块改了。你提醒它，它道歉，然后下一轮又改了。
 
-### 问题 2：非收敛性调试
+**"需求大了就乱套"**
+小功能还行，稍微复杂一点就开始胡说八道。改了 A 忘了 B，修了 B 又破坏了 C。
 
-**痛点**：修复一个 Bug 引入两个新 Bug，陷入"打地鼠"循环。
+**"不知道它到底做没做完"**
+它说"完成了"，但你不敢信。你让它再检查一遍，它说"检查过了，没问题"。你还是不敢信。
 
-**DevBooks 方案**：
-- 角色隔离：Test Owner 先跑出 Red 基线，Coder 不能修改测试
-- 收敛性审计：`devbooks-convergence-audit` 评估变更包是否有效推进
+**"每次都要从头教"**
+上次对话里建立的约定，这次对话全忘了。项目的术语、边界、约束，每次都要重新解释。
 
-### 问题 3：局部最优与全局短视
+**"改完不知道改了什么"**
+它改了一堆文件，你问它改了什么，它给你一个摘要。但这个摘要对不对？你不知道。
 
-**痛点**：AI 倾向于生成"能跑通"的独立代码块，缺乏对整体架构的考量。
-
-**DevBooks 方案**：
-- 设计先行：Design Doc 定义 What/Constraints，不写 How
-- 架构约束：Fitness Rules 验证架构规则
-- 影响分析：变更前评估跨模块影响
+---
 
-### 问题 4：验证疲劳
+## 这些不是 AI 不够聪明，是结构性问题
 
-**痛点**：AI 生成速度极快，人类审查代码的警觉性随时间呈指数下降。
+提示词写得再好也没用。这是 LLM 的工作方式决定的：
 
-**DevBooks 方案**：
-- 自动化质量闸门：Green 证据检查、任务完成率、角色边界检查
-- 强制评审：Reviewer 只审查可维护性，业务正确性由测试保证
+| 问题 | 根本原因 |
+|-----|---------|
+| 说改好了没改好 | 自己写测试验证自己的代码，当然能过 |
+| 改着改着就忘了 | 上下文窗口有限，早期信息被挤出去 |
+| 需求大了就乱 | 复杂度超过单次对话能处理的极限 |
+| 不知道做没做完 | 没有客观证据，只有它的口头声明 |
+| 每次从头教 | 对话是临时的，知识没有持久化 |
+| 不知道改了什么 | 没有可审计的变更记录 |
 
 ---
 
-## 快速开始
-
-### 安装
+## DevBooks：用工程约束解决这些问题
 
 ```bash
-# 全局安装
 npm install -g dev-playbooks-cn
-
-# 在项目中初始化
 dev-playbooks-cn init
+dev-playbooks-cn delivery
 ```
 
-### 更新
+| 问题 | DevBooks 怎么解决 |
+|-----|------------------|
+| 自己验证自己 | **角色隔离**：写测试的 Agent 和写代码的 Agent 必须分开，互相看不到对方的思路 |
+| 上下文遗忘 | **真理落盘**：术语、边界、约束写在文件里，不依赖对话记忆 |
+| 需求太大 | **切片预算**：大需求必须切成小块，每块有复杂度上限，超了就再切 |
+| 口头完成 | **证据定义完成**：测试日志、构建输出必须真的存在于磁盘上 |
+| 每次从头教 | **SSOT（单一真理源）**：项目知识持久化在 specs/，跨对话、跨变更稳定 |
+| 不知道改了什么 | **变更包**：每次变更有完整记录——提案、设计、任务、证据 |
 
-```bash
-dev-playbooks-cn update
-```
+---
 
-### 支持的 AI 工具
+## 它是怎么工作的
 
-| 工具 | 支持级别 |
-|------|----------|
-| Claude Code | 完整 Skills（`.claude/skills/`）|
-| Codex CLI | 完整 Skills（`.codex/skills/`）|
-| Qoder | 完整 Skills |
-| OpenCode | 完整 Skills |
-| Every Code | 完整 Skills |
-| Factory | 原生 Skills（`.factory/skills/`）|
-| Cursor | 原生 Skills（`.cursor/skills/`）|
-| Windsurf | Rules 系统 |
-| Gemini CLI | Rules 系统 |
+你只需要记住一个命令：
 
----
+```bash
+dev-playbooks-cn delivery
+```
 
-## 文档
+系统会问你几个问题，然后生成一份 `RUNBOOK.md`——这是你这次任务的操作手册。照着做就行。
 
-- [使用指南](docs/使用指南.md) - 完整工作流程和最佳实践
-- [Skill 详解](docs/Skill详解.md) - 18 个 Skills 的特色和功能
+```
+你的需求
+    ↓
+Delivery（判断类型、生成 RUNBOOK）
+    ↓
+┌─────────────────────────────────┐
+│ 小改动 → 直接执行                │
+│ 大需求 → 先切片再执行            │
+│ 不确定 → 先研究再决策            │
+└─────────────────────────────────┘
+    ↓
+闸门检查（7 道关卡，任何一道失败都会阻断）
+    ↓
+证据归档（测试日志、构建输出、审批记录）
+```
 
 ---
 
-## 核心理念
+## 核心机制
 
-### 1. 角色隔离（Role Isolation）
+**真理源（SSOT）**
 
-Test Owner 与 Coder **必须在独立对话**中工作。这不是建议，是硬性约束。
+```
+你的需求文档（如果有）
+    ↓ 提取约束
+specs/（术语、边界、决策）← 跨变更稳定的"项目记忆"
+    ↓
+changes/<id>/（本次变更的提案、设计、任务、证据）
+    ↓ 归档
+specs/（更新真理）
+```
 
-**隔离执行基线：**
-- 同一对话不同时编写测试与实现
-- 测试用于验证规格
+如果你没有需求文档，DevBooks 会帮你创建一个最小的。这反而是好事——逼你把模糊的想法写清楚。
 
-### 2. 规格驱动（Spec-Driven）
+**完成合同**
 
-所有代码必须追溯到 AC-xxx（验收标准）。
+把"我要什么"编译成机器可检查的清单：
+- 5 条义务
+- 每条有对应的检查项
+- 每条有对应的证据文件
 
-```
-需求 → Proposal → Design (AC-001, AC-002) → Spec → Tasks → Tests → Code
-```
+不是"大概做完了"，而是"这 5 条都有证据"。
 
-### 3. 证据优先（Evidence-First）
+**7 道闸门（G0-G6）**
 
-完成由证据定义，而非 AI 声明。
+| 闸门 | 检查什么 |
+|-----|---------|
+| G0 | 输入就绪了吗？需求清楚吗？ |
+| G1 | 该有的文件都有吗？ |
+| G2 | 任务都完成了吗？ |
+| G3 | 切片正确吗？（大需求） |
+| G4 | 文档同步了吗？ |
+| G5 | 风险覆盖了吗？（高风险变更） |
+| G6 | 证据完整吗？可以归档吗？ |
 
-必需的证据：
-- 测试通过（Green 证据）
-- 构建成功
-- 静态检查通过
-- 任务完成率 100%
+任何一道失败，流程阻断。不是警告，是阻断。
 
 ---
 
-## 工作流程
+## 目录结构
 
 ```
-1. Proposal（提案）- 分析需求，评估影响
-   ↓
-2. Design（设计）- 定义 What/Constraints + AC-xxx
-   ↓
-3. Spec（规格）- 定义对外行为契约
-   ↓
-4. Plan（计划）- 制定实现计划和任务拆解
-   ↓
-5. Test（测试）- 编写验收测试（独立对话）
-   ↓
-6. Implement（实现）- 实现功能（独立对话）
-   ↓
-7. Review（评审）- 代码评审
-   ↓
-8. Archive（归档）- 归档变更包
+project/
+├── .devbooks/config.yaml     # 配置
+└── dev-playbooks/
+    ├── constitution.md       # 硬约束（不可绕过的规则）
+    ├── specs/                # 真理源（跨变更稳定）
+    └── changes/              # 变更包（每次变更一个目录）
+        └── <change-id>/
+            ├── proposal.md   # 为什么做、做什么
+            ├── design.md     # 怎么做、验收标准
+            ├── tasks.md      # 拆成可执行的步骤
+            ├── verification.md # 怎么证明做对了
+            └── evidence/     # 测试日志、构建输出
 ```
 
 ---
 
-## 18 个 Skills
-
-| Skill | 阶段 | 作用 |
-|-------|------|------|
-| devbooks-router | 入口 | 工作流引导 |
-| devbooks-proposal-author | Proposal | 撰写提案 |
-| devbooks-proposal-challenger | Proposal | 质疑提案 |
-| devbooks-proposal-judge | Proposal | 裁决提案 |
-| devbooks-design-doc | Design | 编写设计文档 |
-| devbooks-spec-contract | Spec | 定义规格契约 |
-| devbooks-implementation-plan | Plan | 制定实现计划 |
-| devbooks-test-owner | Test | 编写验收测试 |
-| devbooks-test-reviewer | Review | 测试评审 |
-| devbooks-coder | Implement | 实现功能 |
-| devbooks-reviewer | Review | 代码评审 |
-| devbooks-archiver | Archive | 归档变更包 |
-| devbooks-docs-consistency | Quality | 文档一致性检查 |
-| devbooks-impact-analysis | Quality | 影响分析 |
-| devbooks-convergence-audit | Quality | 收敛性审计 |
-| devbooks-entropy-monitor | Quality | 熵度量监控 |
-| devbooks-brownfield-bootstrap | Init | 存量项目初始化 |
-| devbooks-delivery-workflow | Full | 完整闭环编排 |
-
-详见 [Skill 详解](docs/Skill详解.md)
-
----
-
-## 传统 AI 编程对照
-
-### 对比传统 AI 编程
-
-| 传统 AI 编程 | DevBooks |
-|-------------|----------|
-| AI 自评"已完成" | 测试通过 + 构建成功 |
-| 同一对话写测试又写代码 | 角色隔离，独立对话 |
-| 无验证闸门 | 多重质量闸门 |
-| 边修边破 | 稳定推进 |
-| 只支持 0→1 项目 | 支持存量项目 |
-
-### 适用场景
+## 下一步
 
-- 新功能开发
-- 重大重构
-- Bug 修复
-- 存量项目接入
-- 需要高质量保证的项目
+- [快速开始](docs/使用指南.md)
+- [设计原理](dev-playbooks/docs/AI软件工程开发框架设计.md)
+- [Skill 详解](docs/Skill详解.md)
 
 ---
 
 ## 许可证
 
-MIT License - 详见 [LICENSE](LICENSE)
+MIT

package/bin/devbooks

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${script_dir}/devbooks.mjs" "$@"