6c9acbc501
- journal: 2026-05-25 完整工作记录 - arch/today.md: 标记完成,列出明日待办 - ROADMAP.md: 进度更新至40%,信息架构重构标为完成 - 从 ai_project 同步 ADR-008 + P-003 到 main Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
可复用模式
目的
记录开发过程中发现的可持续复用的模式和做法。 同样的模式出现 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 自己更新完成状态
P-003: 模板同步 (framework sync)
上下文: 项目框架层(AGENTS/权限/提示词/工作流)的变化需要传播到通用模板分支 问题: 手动同步耗时且容易遗漏,AI 重做去敏化消耗 ~100K tokens 方案:
- 双分支:
main(具体项目)+ai_project(通用模板) SYNC.md明确定义框架层/项目层文件边界sync-template.sh自动 checkout 框架文件 + 重新应用 {{变量}}- 框架层 ~15 个文件自动同步,project 层永久隔离 何时用: main 分支框架有变化时 维护者: Arch AI 触发,脚本执行
反模式(避免)
- 在多个文件中重复同一状态信息 → 只在 ROADMAP.md 记录
- 决策讨论散落在任务 feedback 中 → 提炼到 knowledge/decisions.md
- 大段文档内联而非链接 → 用链接 + 一句话摘要