2026-05-25 16:49:36 +08:00
|
|
|
|
# 可复用模式
|
|
|
|
|
|
|
|
|
|
|
|
## 目的
|
|
|
|
|
|
|
|
|
|
|
|
记录开发过程中发现的可持续复用的模式和做法。
|
|
|
|
|
|
同样的模式出现 3 次以上时，应当记录在这里。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## P-001: AI 任务交接 (review/active/)
|
|
|
|
|
|
|
|
|
|
|
|
**上下文**: AI 角色之间需要传递工作成果
|
|
|
|
|
|
**问题**: 如何结构化任务交接，让任何 AI 都能接手
|
|
|
|
|
|
**方案**: 标准化 `review/active/{任务ID}/` 结构：
|
|
|
|
|
|
- `task.md` — 任务描述（Arch AI 定义）
|
|
|
|
|
|
- `acceptance.md` — 验收标准（Arch AI + Dev AI + QA AI 共同维护）
|
|
|
|
|
|
- `impact.md` — 变更影响范围（Arch AI + Dev AI 评估）
|
|
|
|
|
|
- `feedback/` — 反馈记录（QA AI 提交）
|
|
|
|
|
|
|
|
|
|
|
|
**何时用**: 每个跨 AI 角色的任务
|
|
|
|
|
|
**何时不用**: 单角色任务（如纯文档更新、配置修改）
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## P-002: 角色工作台 (daily task board)
|
|
|
|
|
|
|
|
|
|
|
|
**上下文**: AI 每次会话需要快速进入工作状态
|
|
|
|
|
|
**问题**: 从头探索项目结构浪费时间
|
|
|
|
|
|
**方案**: `.ai/roles/{role}/today.md` 每日任务清单，AI 只需读 2 个文件（card + today）
|
|
|
|
|
|
**何时用**: 每次 AI 会话
|
|
|
|
|
|
**维护者**: Arch AI 负责分配，各 AI 自己更新完成状态
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-05-25 17:23:06 +08:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## P-003: 模板同步 (framework sync)
|
|
|
|
|
|
|
|
|
|
|
|
**上下文**: 项目框架层（AGENTS/权限/提示词/工作流）的变化需要传播到通用模板分支
|
|
|
|
|
|
**问题**: 手动同步耗时且容易遗漏，AI 重做去敏化消耗 ~100K tokens
|
|
|
|
|
|
**方案**:
|
|
|
|
|
|
- 双分支：`main`（具体项目）+ `ai_project`（通用模板）
|
|
|
|
|
|
- `SYNC.md` 明确定义框架层/项目层文件边界
|
|
|
|
|
|
- `sync-template.sh` 自动 checkout 框架文件 + 重新应用 {{变量}}
|
|
|
|
|
|
- 框架层 ~15 个文件自动同步，project 层永久隔离
|
|
|
|
|
|
**何时用**: main 分支框架有变化时
|
|
|
|
|
|
**维护者**: Arch AI 触发，脚本执行
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-05-25 16:49:36 +08:00
|
|
|
|
## 反模式（避免）
|
|
|
|
|
|
|
|
|
|
|
|
- 在多个文件中重复同一状态信息 → 只在 ROADMAP.md 记录
|
|
|
|
|
|
- 决策讨论散落在任务 feedback 中 → 提炼到 knowledge/decisions.md
|
|
|
|
|
|
- 大段文档内联而非链接 → 用链接 + 一句话摘要
|
