Files
ai_soc_sw/.ai/knowledge/patterns.md
T
tupingr 6c9acbc501 chore(arch): 记录今日工作 + 更新明日任务 + 同步知识库
- 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>
2026-05-25 17:23:06 +08:00

1.9 KiB
Raw Blame History

可复用模式

目的

记录开发过程中发现的可持续复用的模式和做法。 同样的模式出现 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
  • 大段文档内联而非链接 → 用链接 + 一句话摘要