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-project-profile.md

@@ -0,0 +1,159 @@
+# Project Profile 文档模板
+
+> 本模板定义了 project-profile.md 的标准结构，用于记录用户画像、核心需求和决策偏好。
+
+## 文件位置
+
+```
+<truth-root>/specs/_meta/project-profile.md
+```
+
+## 标准结构
+
+```markdown
+# 项目画像：<项目名称>
+
+## 👤 你是谁？（角色定位）
+
+**当前角色**：[快速上手者 / 平台构建者 / 快速验证者 / 其他]
+
+**角色特征**：
+- 核心需求：[简单、快速、够用 / 可扩展、高质量 / 最快看到效果]
+- 技术偏好：[开箱即用 / 架构优先 / 原型优先]
+- 时间预算：[1-2 天 / 1-2 周 / 不限]
+- 技术水平：[初级 / 中级 / 高级]
+
+**角色演变**：
+- [日期]：[角色]（初始）
+- [日期]：[角色]（升级）← 如果升级
+
+---
+
+## 🎯 你要什么？（核心需求）
+
+### 显性需求（你明确说的）
+
+**功能需求**：
+- ✅ [需求 1]
+- ✅ [需求 2]
+- ❌ 不需要 [需求 3]
+
+**非功能需求**：
+- ✅ 准确率 >[X]%
+- ✅ 性能 <[X] 秒
+- ✅ 内存 <[X]MB
+
+---
+
+### 隐藏需求（你没说但需要的）
+
+**团队协作**：
+- 团队人数：[X] 人
+- 是否需要共享缓存：[是 / 否]
+- 决策理由：[理由]
+
+**CI/CD 集成**：
+- 是否有 CI：[是 / 否]
+- 是否需要集成：[是 / 否]
+- 决策理由：[理由]
+
+**离线使用**：
+- 是否需要离线：[是 / 否]
+- 决策理由：[理由]
+
+**多项目支持**：
+- 是否多项目：[是 / 否]
+- 决策理由：[理由]
+
+**历史版本分析**：
+- 是否需要：[是 / 否]
+- 决策理由：[理由]
+
+---
+
+## 🚫 你不要什么？（边界条件）
+
+**明确不做的事情**：
+- ❌ [不做的事情 1]
+- ❌ [不做的事情 2]
+
+**技术约束**：
+- ✅ 可以装新工具
+- ❌ 不能用云端服务
+- ✅ 可以占用空间（<[X]MB）
+
+**时间约束**：
+- ⏰ 必须 [X] 周内完成
+- ⏰ 每个里程碑 <[X] 天
+
+---
+
+## 🧭 你的北极星（长期目标）
+
+**长期愿景**：
+[描述长期愿景]
+
+**核心价值**：
+- [价值 1] > [价值 2]
+- [价值 3] > [价值 4]
+
+**不做什么**：
+- 不做 [事情 1]（原因：[原因]）
+- 不做 [事情 2]（原因：[原因]）
+
+---
+
+## 📊 决策偏好（历史决策）
+
+**技术选型偏好**：
+- 倾向：[成熟稳定 / 新潮前沿]
+- 示例：[示例]
+
+**架构偏好**：
+- 倾向：[简单直接 / 复杂灵活]
+- 示例：[示例]
+
+**质量偏好**：
+- 倾向：[准确性 / 性能]
+- 示例：[示例]
+
+---
+
+## 🔄 画像更新日志
+
+| 日期 | 变化 | 原因 |
+|------|------|------|
+| [日期] | 创建画像 | 初始化项目 |
+| [日期] | 角色升级：[旧角色] → [新角色] | [原因] |
+| [日期] | 新增需求：[需求] | [原因] |
+```
+
+## 使用指南
+
+### 1. 谁来写 Project Profile？
+
+- **初始化**：brownfield-bootstrap skill 在项目初始化时创建
+- **更新**：proposal-author skill 在每次提案时更新
+- **维护**：archiver skill 在归档时同步更新
+
+### 2. 谁来读 Project Profile？
+
+| Skill | 读取目的 |
+|-------|----------|
+| proposal-author | 了解用户画像，推荐合适的方案 |
+| design-doc | 了解技术偏好，选择合适的架构 |
+| implementation-plan | 了解时间约束，制定合理的计划 |
+| archiver | 更新画像，记录决策演变 |
+
+### 3. 画像的作用
+
+- **个性化推荐**：基于用户画像推荐合适的方案
+- **决策一致性**：确保所有决策符合用户的长期目标
+- **知识沉淀**：记录用户的决策偏好，避免重复询问
+
+### 4. 画像的更新频率
+
+- **初始化**：项目创建时
+- **角色升级**：用户需求发生重大变化时
+- **新增需求**：发现新的隐藏需求时
+- **定期回顾**：每季度回顾一次，确保画像准确

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

@@ -0,0 +1,226 @@
+# Proposal 文档模板
+
+> 本模板定义了 proposal.md 的标准结构，确保提案清晰、可审查、可落地。
+
+## 文件位置
+
+```
+<change-root>/<change-id>/proposal.md
+```
+
+## 标准结构
+
+```markdown
+# <变更标题>
+
+## 🎯 结论先行（30秒阅读）
+
+**本提案会导致**：
+- ✅ [会发生什么变化 1]
+- ✅ [会发生什么变化 2]
+- ✅ [会发生什么变化 3]
+
+**本提案不会导致**：
+- ❌ [不会发生什么 1]
+- ❌ [不会发生什么 2]
+
+**一句话总结**：[用大白话说明这个变更是什么]
+
+---
+
+## 🤔 需求对齐（5分钟阅读）
+
+> 目的：确保方向正确，挖掘隐藏需求
+
+### 你是谁？（角色定位）
+
+请选择最符合你的描述：
+
+- [ ] **快速上手者**：只想快速实现功能，不想折腾
+  - 核心需求：简单、快速、够用
+  - 技术偏好：开箱即用，不要复杂配置
+
+- [ ] **平台构建者**：想把它发展为平台，服务更多用户
+  - 核心需求：可扩展、高质量、多场景
+  - 技术偏好：架构优先，质量优先
+
+- [ ] **快速验证者**：想快速验证想法，不确定是否有用
+  - 核心需求：最快看到效果，可以后续优化
+  - 技术偏好：原型优先，快速迭代
+
+**如果你不确定**：默认选择"快速上手者"，后续可以升级。
+
+---
+
+### 你要什么？（核心需求）
+
+**基础需求**（所有角色都需要）：
+- [x] [需求 1]
+- [x] [需求 2]
+
+**进阶需求**（根据角色选择）：
+- [ ] [进阶需求 1]
+- [ ] [进阶需求 2]
+
+**如果你不确定**：只勾选基础需求，进阶需求可以后续加。
+
+---
+
+### 你可能没想到什么？（隐藏需求）
+
+> 目的：帮你发现可能忽略的需求
+
+#### 隐藏需求 1：[需求名称]
+
+**问题**：[用问题的方式引导用户思考]
+
+**为什么重要**：[说明为什么这个需求重要]
+
+**请选择**：
+- [ ] [选项 A]
+- [ ] [选项 B]
+
+**默认选择**：[选项 A]
+
+---
+
+### 🎯 基于你的选择，推荐方案
+
+**如果你选择了"快速上手者"**：
+推荐方案：简单够用版
+- [方案描述]
+- 代价：[说明代价]
+
+**如果你选择了"平台构建者"**：
+推荐方案：完整平台版
+- [方案描述]
+- 代价：[说明代价]
+
+**如果你没有选择**：
+默认方案：快速上手版
+
+---
+
+## ✅ 批准流程（1分钟）
+
+### 快速批准（推荐）
+
+**如果你同意推荐方案**：
+- [ ] ✅ 我同意推荐方案，直接开始
+
+**如果你想自定义**：
+- [ ] 🔧 我想自定义方案（需要填写下面的表格）
+
+**如果你不确定**：
+- [ ] 🤔 我需要更多信息
+
+**默认选择**：✅ 我同意推荐方案（24小时后自动批准）
+
+---
+
+## 📋 详细提案（AI阅读）
+
+### Why（为什么要改）
+
+#### 问题描述
+
+[描述当前存在的问题]
+
+#### 影响
+
+[说明问题的影响范围和严重程度]
+
+---
+
+### What（要改什么）
+
+#### 目标
+
+[描述变更的目标]
+
+#### 范围
+
+[说明变更的范围]
+
+---
+
+### Impact（影响分析）
+
+#### 受影响的模块
+
+| 模块 | 影响类型 | 影响程度 |
+|------|----------|----------|
+| [模块1] | [新增/修改/删除] | [高/中/低] |
+
+#### 风险
+
+| 风险 | 概率 | 影响 | 缓解措施 |
+|------|------|------|----------|
+| [风险1] | [高/中/低] | [高/中/低] | [缓解措施] |
+
+---
+
+### Alternatives（备选方案）
+
+#### 方案 A：[方案名称]
+
+**优势**：
+- [优势1]
+
+**劣势**：
+- [劣势1]
+
+**适合**：[适合什么场景]
+
+#### 方案 B：[方案名称]
+
+**优势**：
+- [优势1]
+
+**劣势**：
+- [劣势1]
+
+**适合**：[适合什么场景]
+
+---
+
+### Decision（决策）
+
+**选择方案**：[方案名称]
+
+**理由**：[说明选择理由]
+
+---
+
+## 批准历史
+
+| 时间 | 阶段 | 操作 | 操作者 | 理由 |
+|------|------|------|--------|------|
+| [时间] | Proposal | 创建 | AI | - |
+| [时间] | Proposal | 批准 | 用户 | [理由] |
+```
+
+## 使用指南
+
+### 1. 结论先行的作用
+
+- **30秒快速理解**：让用户立即知道"会导致什么，不会导致什么"
+- **降低认知负担**：用大白话，不用专业术语
+- **建立预期**：明确说明变化范围
+
+### 2. 需求对齐的作用
+
+- **角色定位**：帮助用户明确自己的角色和需求
+- **挖掘隐藏需求**：通过问题引导用户思考可能忽略的需求
+- **推荐方案**：基于角色给出推荐方案
+
+### 3. 批准流程的作用
+
+- **默认批准**：用户不说话 = 同意（24小时后自动批准）
+- **降低决策负担**：大部分情况下用户不需要手动批准
+- **保留控制权**：用户可以随时拒绝或自定义
+
+### 4. 详细提案的作用
+
+- **AI阅读**：提供完整的技术细节供AI参考
+- **人类可跳过**：人类只需要读"结论先行"和"需求对齐"部分

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

@@ -0,0 +1,181 @@
+# Tasks 文档模板
+
+> 本模板定义了 tasks.md 的标准结构，确保任务清晰、可执行、可跟踪。
+
+## 文件位置
+
+```
+<change-root>/<change-id>/tasks.md
+```
+
+## 标准结构
+
+```markdown
+# <变更标题> - 任务计划
+
+## 🎯 结论先行（30秒阅读）
+
+**本任务会导致**：
+- ✅ [会实现什么功能 1]
+- ✅ [会实现什么功能 2]
+- ✅ 开发时间：[X-Y 天]
+
+**本任务不会导致**：
+- ❌ [不会修改什么 1]
+- ❌ [不会影响什么 2]
+
+**与 Design 的差异**：
+- 📝 Design 说"[Design 的内容]"
+- 🔨 Tasks 说"分 [X] 个里程碑实现"
+
+---
+
+## ⚡ 快速批准（30秒）
+
+**任务拆分**：
+- MP1：[里程碑 1]（[X-Y 天]）
+- MP2：[里程碑 2]（[X-Y 天]）
+- MP3：[里程碑 3]（[X-Y 天]）
+
+**如果你同意**：
+- [ ] ✅ 同意任务拆分，开始实现
+
+**如果你想调整**：
+- [ ] 🔧 我想调整优先级（请说明）
+- [ ] 🔧 我想调整时间（请说明）
+
+**默认选择**：✅ 同意任务拆分（24小时后自动批准）
+
+---
+
+## ✅ 批准流程（1分钟）
+
+**当前状态**：
+- 📝 状态：待批准
+- ⏰ 创建时间：[时间]
+- ⏰ 超时时间：[时间]（24小时后）
+
+**如果你同意**：
+- [ ] ✅ 批准任务计划，开始实现
+
+**如果你不同意**：
+- [ ] ❌ 拒绝任务计划，说明理由：[理由]
+
+**默认选择**：✅ 批准任务计划（24小时后自动批准）
+
+---
+
+## 📋 详细任务（AI阅读）
+
+### 主线计划（Main Plan）
+
+#### MP1: [里程碑 1 标题]
+
+**目标**：[描述里程碑目标]
+
+**任务列表**：
+- [ ] Task 1.1: [任务描述]
+  - 预计时间：[X 小时]
+  - 依赖：无
+  - 验收标准：[验收标准]
+
+- [ ] Task 1.2: [任务描述]
+  - 预计时间：[X 小时]
+  - 依赖：Task 1.1
+  - 验收标准：[验收标准]
+
+**里程碑验收**：
+- [ ] [验收条件 1]
+- [ ] [验收条件 2]
+
+---
+
+#### MP2: [里程碑 2 标题]
+
+**目标**：[描述里程碑目标]
+
+**任务列表**：
+- [ ] Task 2.1: [任务描述]
+  - 预计时间：[X 小时]
+  - 依赖：MP1
+  - 验收标准：[验收标准]
+
+**里程碑验收**：
+- [ ] [验收条件 1]
+- [ ] [验收条件 2]
+
+---
+
+### 临时计划（Temp Plan）
+
+> 实现过程中发现的临时任务
+
+- [ ] Temp 1: [临时任务描述]
+  - 发现时间：[时间]
+  - 原因：[为什么需要这个任务]
+  - 预计时间：[X 小时]
+
+---
+
+### 断点区（Checkpoint）
+
+> 记录实现过程中的关键决策和问题
+
+#### Checkpoint 1: [时间]
+
+**问题**：[遇到的问题]
+
+**决策**：[做出的决策]
+
+**影响**：[对任务计划的影响]
+
+---
+
+### 进度跟踪
+
+| 里程碑 | 状态 | 完成时间 | 备注 |
+|--------|------|----------|------|
+| MP1 | ✅ 已完成 | [时间] | - |
+| MP2 | 🔄 进行中 | - | - |
+| MP3 | ⏳ 待开始 | - | - |
+
+---
+
+## 批准历史
+
+| 时间 | 阶段 | 操作 | 操作者 | 理由 |
+|------|------|------|--------|------|
+| [时间] | Tasks | 创建 | AI | - |
+| [时间] | Tasks | 批准 | 用户 | [理由] |
+```
+
+## 使用指南
+
+### 1. 结论先行的作用
+
+- **30秒快速理解**：让用户立即知道任务的核心内容
+- **时间预估**：明确说明开发时间
+- **降低认知负担**：用大白话，不用专业术语
+
+### 2. 快速批准的作用
+
+- **任务拆分**：将大任务拆分为可管理的里程碑
+- **快速决策**：用户只需要确认"同意"或"调整"
+- **默认批准**：24小时后自动批准
+
+### 3. 主线计划的作用
+
+- **结构化**：按里程碑组织任务
+- **可跟踪**：每个任务都有明确的验收标准
+- **可并行**：明确任务之间的依赖关系
+
+### 4. 临时计划的作用
+
+- **灵活性**：记录实现过程中发现的临时任务
+- **可追溯**：说明为什么需要这个任务
+
+### 5. 断点区的作用
+
+- **决策记录**：记录实现过程中的关键决策
+- **问题追踪**：记录遇到的问题和解决方案
+- **知识沉淀**：为后续类似任务提供参考