chore(blueprint): 本项目应用 AGENTS.md 单一来源结构(规则同步产物)
This commit is contained in:
parent
45ce0ad9be
commit
f9b02f7a34
38
AGENTS.md
38
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_MANAGED_START version="1.9.0" -->
|
||||
## 项目蓝图
|
||||
|
||||
本项目使用 `.blueprint/` 目录维护项目全景架构图,驱动需求讨论和任务管理。
|
||||
本节适用于任何 AI 编程工具(Claude / Qwen / Cursor / Copilot 等)。
|
||||
|
||||
### 对话开始时必须执行
|
||||
|
||||
1. 读取 `.blueprint/manifest.yaml` 了解项目全景和当前状态
|
||||
2. 读取 `.blueprint/CONVENTIONS.md` 了解完整工作流规则
|
||||
|
||||
### 需求讨论 → 蓝图同步规则
|
||||
|
||||
| 用户说的 | AI 应做的 |
|
||||
|----------|--------------|
|
||||
| "我想加个 XX 功能" | 确认需求后:manifest 新增模块(status: concept),创建 `.blueprint/modules/<id>.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`。
|
||||
<!-- BLUEPRINT_MANAGED_END -->
|
||||
|
||||
32
CLAUDE.md
32
CLAUDE.md
@ -50,36 +50,10 @@ docs/templates/ 炼境接入包模板草案(agents-meta-rules
|
||||
<!-- BLUEPRINT_MANAGED_START version="1.9.0" -->
|
||||
## 项目蓝图
|
||||
|
||||
本项目使用 `.blueprint/` 目录维护项目全景架构图,驱动需求讨论和任务管理。
|
||||
|
||||
### 对话开始时必须执行
|
||||
蓝图工作流规则统一维护在 @AGENTS.md 的 BLUEPRINT_MANAGED 区(跨工具单一来源,勿在此复制)。
|
||||
|
||||
对话开始时必须执行:
|
||||
1. 读取 `.blueprint/manifest.yaml` 了解项目全景和当前状态
|
||||
2. 读取 `.blueprint/CONVENTIONS.md` 了解完整工作流规则
|
||||
|
||||
### 需求讨论 → 蓝图同步规则
|
||||
|
||||
| 用户说的 | Claude 应做的 |
|
||||
|----------|--------------|
|
||||
| "我想加个 XX 功能" | 确认需求后:manifest 新增模块(status: concept),创建 `.blueprint/modules/<id>.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 中的蓝图工作流(需求→蓝图同步、复杂度决策、两阶段提交)
|
||||
<!-- BLUEPRINT_MANAGED_END -->
|
||||
|
||||
Loading…
Reference in New Issue
Block a user