diff --git a/AGENTS.md b/AGENTS.md index 5130f17..6b2cecf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -109,3 +109,41 @@ docs/templates/ 炼境接入包模板草案（设计层） - [ ] `project-brief.md` 最近 30 天有没有随架构改动更新？ - [ ] `src/lib/commands.ts` 的封装覆盖了所有 `src-tauri/src/commands/` 下的 command 吗？ - [ ] 接入包模板（`resources/onboarding/`）和 `docs/templates/` 内容一致吗？ + + +## 项目蓝图 + +本项目使用 `.blueprint/` 目录维护项目全景架构图，驱动需求讨论和任务管理。 +本节适用于任何 AI 编程工具（Claude / Qwen / Cursor / Copilot 等）。 + +### 对话开始时必须执行 + +1. 读取 `.blueprint/manifest.yaml` 了解项目全景和当前状态 +2. 读取 `.blueprint/CONVENTIONS.md` 了解完整工作流规则 + +### 需求讨论 → 蓝图同步规则 + +| 用户说的 | AI 应做的 | +|----------|--------------| +| "我想加个 XX 功能" | 确认需求后：manifest 新增模块（status: concept），创建 `.blueprint/modules/.md` | +| "XX 功能需要 A、B、C" | 在模块文件中拆分为任务卡 | +| "这个方案确定了" | 模块 status → planned，补充任务卡 files/acceptance | +| "开始做 XX" | 模块 status → in_progress | +| 没提蓝图但在讨论功能 | 主动提议更新蓝图 | + +### 复杂度决策（讨论新功能 / 拆解需求时） + +| complexity | 执行流程 | +|-----------|---------| +| S / M | 直接拆任务卡，确保每张卡有 `files` + `acceptance` + `complexity` → 标记 📋 | +| L（复杂系统设计） | 先做架构设计（Claude 用 `/architect` 技能，其他工具按 CONVENTIONS「复杂功能分析流程」章节执行）输出设计文档，用户确认后拆成 S/M 任务卡 | + +> L 级任务禁止直接写代码，必须先经过 架构设计 → 任务拆解 流程。 + +### 任务执行两阶段提交 + +- **开始写代码前**：任务卡前缀改为 🔵，status → in_progress +- **完成验收后**：任务卡前缀改为 ✅，status → done，更新 manifest `updated` 日期 + +完整规则（迭代管理、阻塞处理、复盘笔记等）详见 `.blueprint/CONVENTIONS.md`。 + diff --git a/CLAUDE.md b/CLAUDE.md index 89a129b..de6ff6f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -50,36 +50,10 @@ docs/templates/ 炼境接入包模板草案（agents-meta-rules ## 项目蓝图 -本项目使用 `.blueprint/` 目录维护项目全景架构图，驱动需求讨论和任务管理。 - -### 对话开始时必须执行 +蓝图工作流规则统一维护在 @AGENTS.md 的 BLUEPRINT_MANAGED 区（跨工具单一来源，勿在此复制）。 +对话开始时必须执行： 1. 读取 `.blueprint/manifest.yaml` 了解项目全景和当前状态 2. 读取 `.blueprint/CONVENTIONS.md` 了解完整工作流规则 - -### 需求讨论 → 蓝图同步规则 - -| 用户说的 | Claude 应做的 | -|----------|--------------| -| "我想加个 XX 功能" | 确认需求后：manifest 新增模块（status: concept），创建 `.blueprint/modules/.md` | -| "XX 功能需要 A、B、C" | 在模块文件中拆分为任务卡 | -| "这个方案确定了" | 模块 status → planned，补充任务卡 files/acceptance | -| "开始做 XX" | 模块 status → in_progress | -| 没提蓝图但在讨论功能 | 主动提议更新蓝图 | - -### 复杂度决策（讨论新功能 / 拆解需求时） - -| complexity | 执行流程 | -|-----------|---------| -| S / M | 直接拆任务卡，确保每张卡有 `files` + `acceptance` + `complexity` → 标记 📋 | -| L（复杂系统设计） | 先 `/architect` 输出设计文档，用户确认后 `/splitter` 拆成 S/M 任务卡 | - -> L 级任务禁止直接写代码，必须先经过 `/architect` → `/splitter` 流程。 - -### 任务执行两阶段提交 - -- **开始写代码前**：任务卡前缀改为 🔵，status → in_progress -- **完成验收后**：任务卡前缀改为 ✅，status → done，更新 manifest `updated` 日期 - -完整规则（迭代管理、阻塞处理、复盘笔记等）详见 `.blueprint/CONVENTIONS.md`。 +3. 遵循 AGENTS.md 中的蓝图工作流（需求→蓝图同步、复杂度决策、两阶段提交）