dev-playbooks-cn 1.7.3 → 2.0.0

package/skills/_shared/references//346/226/207/346/241/243/346/250/241/346/235/277-verification.md

@@ -0,0 +1,186 @@
+# Verification 文档模板
+
+> 本模板定义了 verification.md 的标准结构，确保验收清晰、可测试、可追溯。
+
+## 文件位置
+
+```
+<change-root>/<change-id>/verification.md
+```
+
+## 标准结构
+
+```markdown
+# <变更标题> - 验收文档
+
+## 🎯 结论先行（30秒阅读）
+
+**本验收会导致**：
+- ✅ 运行 [X] 个测试用例
+- ✅ 验证准确率 >[X]%
+- ✅ 验证性能 <[X] 秒
+
+**本验收不会导致**：
+- ❌ 不会修改代码
+- ❌ 不会影响功能
+
+**验收标准**：
+- ✅ 所有测试通过
+- ✅ 准确率 >[X]%
+- ✅ 性能 <[X] 秒
+
+---
+
+## ✅ 验收批准（30秒）
+
+**测试结果**：
+- ✅ 单元测试：[X]/[Y] 通过
+- ✅ 集成测试：[X]/[Y] 通过
+- ✅ 性能测试：通过（[X] 秒）
+
+**如果你同意**：
+- [ ] ✅ 验收通过，可以归档
+
+**如果你不同意**：
+- [ ] ❌ 验收不通过（请说明原因）
+
+**默认选择**：✅ 验收通过（12小时后自动批准）
+
+---
+
+## ✅ 批准流程（1分钟）
+
+**当前状态**：
+- 📝 状态：待批准
+- ⏰ 创建时间：[时间]
+- ⏰ 超时时间：[时间]（12小时后）
+
+**如果你同意**：
+- [ ] ✅ 批准验收，开始归档
+
+**如果你不同意**：
+- [ ] ❌ 拒绝验收，说明理由：[理由]
+
+**默认选择**：✅ 批准验收（12小时后自动批准）
+
+---
+
+## 📋 详细验证（AI阅读）
+
+### 测试覆盖
+
+#### 单元测试
+
+| 测试用例 | 状态 | 说明 |
+|----------|------|------|
+| test_xxx_1 | ✅ 通过 | [说明] |
+| test_xxx_2 | ✅ 通过 | [说明] |
+
+**覆盖率**：[X]%
+
+---
+
+#### 集成测试
+
+| 测试用例 | 状态 | 说明 |
+|----------|------|------|
+| test_integration_1 | ✅ 通过 | [说明] |
+| test_integration_2 | ✅ 通过 | [说明] |
+
+---
+
+#### 性能测试
+
+| 指标 | 目标 | 实际 | 状态 |
+|------|------|------|------|
+| 响应时间 | <[X]ms | [Y]ms | ✅ 通过 |
+| 吞吐量 | >[X] QPS | [Y] QPS | ✅ 通过 |
+| 内存占用 | <[X]MB | [Y]MB | ✅ 通过 |
+
+---
+
+### 验收标准追溯
+
+#### AC-001: [验收标准标题]
+
+**来源**：design.md AC-001
+
+**验收条件**：
+- [x] [条件1] - 测试用例：test_xxx_1
+- [x] [条件2] - 测试用例：test_xxx_2
+
+**验证结果**：✅ 通过
+
+---
+
+#### AC-002: [验收标准标题]
+
+**来源**：design.md AC-002
+
+**验收条件**：
+- [x] [条件1] - 测试用例：test_xxx_3
+- [x] [条件2] - 测试用例：test_xxx_4
+
+**验证结果**：✅ 通过
+
+---
+
+### 回归测试
+
+#### 现有功能验证
+
+| 功能 | 测试用例 | 状态 | 说明 |
+|------|----------|------|------|
+| [功能1] | test_regression_1 | ✅ 通过 | 未受影响 |
+| [功能2] | test_regression_2 | ✅ 通过 | 未受影响 |
+
+---
+
+### 文档验证
+
+#### 文档更新检查
+
+- [x] README.md 已更新
+- [x] 使用文档已更新
+- [x] API 文档已更新
+- [x] CHANGELOG.md 已更新
+
+---
+
+## 批准历史
+
+| 时间 | 阶段 | 操作 | 操作者 | 理由 |
+|------|------|------|--------|------|
+| [时间] | Verification | 创建 | AI | - |
+| [时间] | Verification | 批准 | 用户 | [理由] |
+```
+
+## 使用指南
+
+### 1. 结论先行的作用
+
+- **30秒快速理解**：让用户立即知道验收的核心内容
+- **测试结果**：明确说明测试结果
+- **降低认知负担**：用大白话，不用专业术语
+
+### 2. 验收批准的作用
+
+- **快速决策**：用户只需要确认"通过"或"不通过"
+- **默认批准**：12小时后自动批准（比其他阶段更短）
+- **保留控制权**：用户可以随时拒绝验收
+
+### 3. 验收标准追溯的作用
+
+- **可追溯**：每个验收标准都应该与 Design 的 AC 对应
+- **可验证**：每个验收条件都应该有对应的测试用例
+- **完整性检查**：确保所有 AC 都被验证
+
+### 4. 回归测试的作用
+
+- **防止破坏**：确保现有功能未受影响
+- **质量保证**：确保变更不会引入新的问题
+
+### 5. 文档验证的作用
+
+- **文档同步**：确保文档与代码同步
+- **用户体验**：确保用户能够正确使用新功能

package/skills/devbooks-brownfield-bootstrap/references//344/273/243/347/240/201/345/257/274/350/210/252/347/255/226/347/225/245.md

@@ -1,6 +1,6 @@
 # 代码导航策略（四步法）
 
-借鉴 VS Code 的 `copilot-instructions.md`，本文档定义了在存量项目中快速定位代码的标准流程。
+本文档定义了在存量项目中快速定位代码的标准流程。
 
 ---
 

package/skills/devbooks-coder/references//346/227/245/345/277/227/350/247/204/350/214/203.md

@@ -1,6 +1,6 @@
 # 日志规范
 
-借鉴 VS Code 的日志实践，本文档定义了应用程序日志的标准规范。
+本文档定义了应用程序日志的标准规范。
 
 ---
 

package/skills/devbooks-coder/references//347/274/226/347/240/201/351/243/216/346/240/274/347/273/206/345/210/231.md

@@ -1,6 +1,6 @@
 # 编码风格细则
 
-借鉴 VS Code 的 `guidelines/CODING_GUIDELINES.md`，本文档定义了代码风格的具体规范。
+本文档定义了代码风格的具体规范。
 
 ---
 

package/skills/devbooks-coder/references//351/224/231/350/257/257/347/240/201/350/247/204/350/214/203.md

@@ -1,6 +1,6 @@
 # 错误码规范
 
-借鉴 VS Code 错误处理模式，本文档定义了应用程序错误码的标准规范。
+本文档定义了应用程序错误码的标准规范。
 
 ---
 

package/skills/devbooks-design-doc/references//351/232/220/347/247/201/345/220/210/350/247/204/346/243/200/346/237/245/346/270/205/345/215/225.md

@@ -1,6 +1,6 @@
 # Telemetry 隐私合规检查项
 
-借鉴 VS Code 的 `telemetry.instructions.md`，本文档定义了埋点/遥测数据的隐私合规要求。
+本文档定义了埋点/遥测数据的隐私合规要求。
 
 ---
 

package/skills/devbooks-proposal-author/references//346/217/220/346/241/210/346/222/260/345/206/231/346/217/220/347/244/272/350/257/215.md

@@ -4,13 +4,15 @@
 
 最高指示（优先级最高）：
 - 在执行本提示词前，先阅读 `~/.claude/skills/_shared/references/AI行为规范.md` 并遵循其中所有协议。
+- **必须**先阅读 `~/.claude/skills/_shared/references/文档模板-proposal.md` 了解新的文档结构。
 
 你是"提案负责人（Proposal Author）"。你的任务是在 proposal 阶段产出清晰、可审查、可落地的变更提案，确保范围最小且可验证。
 
 输入材料（由我提供）：
 - 需求与目标（1–3 句）
 - 当前真理：`<truth-root>/`
-- 项目画像：`<truth-root>/_meta/project-profile.md`
+- 项目画像：`<truth-root>/_meta/project-profile.md`（如存在）
+- 决策日志：`<truth-root>/_meta/decision-log.md`（如存在）
 - 统一语言表（如存在）：`<truth-root>/_meta/glossary.md`
 - 已有影响分析（如有）
 
@@ -51,26 +53,48 @@
 - 兼容性策略（是否保留向后兼容）
 
 输出格式（严格）：
-1) **Why**（问题与目标）
-2) **What Changes**（范围、非目标、影响范围）
-3) **Impact**（对外契约/数据/模块/测试/价值信号/价值流瓶颈假设）
-   - **Transaction Scope**: `None | Single-DB | Cross-Service | Eventual`（必填，标明事务边界复杂度）
-4) **Risks & Rollback**（风险与回滚）
-5) **Validation**（候选验收锚点 + 证据落点）
-6) **Debate Packet**（争议点/不确定点/需要辩论的问题）
-   - 对于设计性决策，使用以下格式：
-     ```
-     #### DP-XX：<决策主题>（需用户决策）
-
-     **选项**：
-     - A：<选项描述> - 优点：xxx；缺点：xxx
-     - B：<选项描述> - 优点：xxx；缺点：xxx
-
-     **Author 建议**：<建议选项及理由>
-     **等待用户选择**
-     ```
-7) **Decision Log（占位）**：
-   - 决策状态：`Pending | Approved | Revise | Rejected`
-   - 需要裁决的问题清单
+
+**必须按照 `~/.claude/skills/_shared/references/文档模板-proposal.md` 的结构输出，包括：**
+
+1) **🎯 结论先行（30秒阅读）**
+   - 本提案会导致：[用大白话列出 3-5 个变化]
+   - 本提案不会导致：[用大白话列出 2-3 个不变的事情]
+   - 一句话总结：[用大白话说明这个变更是什么]
+
+2) **🤔 需求对齐（5分钟阅读）**
+   - 你是谁？（角色定位）：提供 3-4 个角色选项，让用户选择
+   - 你要什么？（核心需求）：列出基础需求和进阶需求
+   - 你可能没想到什么？（隐藏需求）：通过问题引导用户思考
+   - 基于你的选择，推荐方案：根据不同角色推荐不同方案
+
+3) **✅ 批准流程（1分钟）**
+   - 快速批准（推荐）：提供默认选项
+   - 默认选择：✅ 我同意推荐方案（24小时后自动批准）
+
+4) **📋 详细提案（AI阅读）**
+   - Why（为什么要改）
+   - What（要改什么）
+   - Impact（影响分析）
+     - **Transaction Scope**: `None | Single-DB | Cross-Service | Eventual`（必填）
+   - Alternatives（备选方案）
+   - Decision（决策）
+
+5) **批准历史**
+   - 记录所有批准操作
+
+**关键原则**：
+- "结论先行"和"需求对齐"部分必须用**大白话**，避免专业术语
+- 假设用户是小白，不懂技术
+- 用直观、简单的语言说明优劣势
+- 提供多视角的推荐决策，帮助用户理清需求
+
+**设计性决策处理**：
+- 在"需求对齐"部分呈现选项
+- 在"详细提案"的 Alternatives 部分详细说明
+- 等待用户选择，不自行拍板
+
+**决策日志更新**：
+- 如果 `<truth-root>/_meta/decision-log.md` 存在，在做出重要决策后更新它
+- 记录决策的背景、选项、理由和影响
 
 现在开始输出 `proposal.md` Markdown，不要输出额外解释。

package/skills/devbooks-reviewer/references/PR/346/250/241/346/235/277/344/270/216/346/214/207/345/215/227.md

@@ -1,6 +1,6 @@
 # Pull Request 模板与指南
 
-借鉴 VS Code 的 `.github/pull_request_template.md`，本文档定义了 PR 提交的标准流程。
+本文档定义了 PR 提交的标准流程。
 
 ---
 

package/skills/devbooks-reviewer/references//345/235/217/345/221/263/351/201/223/351/200/237/346/237/245/350/241/250.md

@@ -403,9 +403,7 @@ class PaymentService:
 
 ---
 
-## 10. VS Code 风格代码卫生检查
-
-> 借鉴 VS Code ESLint 自定义规则，作为代码评审的自动化检查项
+## 10. 代码卫生检查
 
 ### 禁止提交的模式（阻塞级）
 

package/skills/devbooks-reviewer/references//350/265/204/346/272/220/347/256/241/347/220/206/345/256/241/346/237/245/346/270/205/345/215/225.md

@@ -1,6 +1,6 @@
 # 资源管理审查清单
 
-借鉴 VS Code 的 `code-no-potentially-unsafe-disposables` 和 `code-must-use-super-dispose` 规则。
+本文档定义了资源管理的审查要点。
 
 ---
 

package/skills/devbooks-spec-contract/references/API/350/256/276/350/256/241/346/214/207/345/215/227.md

@@ -1,6 +1,6 @@
 # API 设计指南
 
-借鉴 VS Code Extension API 设计原则，本文档定义了 API 设计的最佳实践。
+本文档定义了 API 设计的最佳实践。
 
 ---
 

package/skills/devbooks-test-owner/references//346/265/213/350/257/225/345/210/206/345/261/202/347/255/226/347/225/245.md

@@ -1,6 +1,6 @@
 # 测试分层策略
 
-借鉴 VS Code 的测试组织模式，本文档定义了测试分层的最佳实践。
+本文档定义了测试分层的最佳实践。
 
 ---
 
@@ -234,7 +234,7 @@ if (process.env.NODE_ENV === 'development') {
 
 ---
 
-## 6) 测试反脆弱策略（借鉴 VS Code Audit.md）
+## 6) 测试反脆弱策略
 
 ### 避免脆弱的选择器