tupingr
4184a6d0b5
新增四层信息架构： - Layer 0: 角色工作台 (.ai/roles/) — AI 每天只需读2个小文件 - Layer 1: 路线图看板 (ROADMAP.md) — 人机共享进度 - Layer 2: 阶段上下文 (.ai/phases/) — 按当前阶段加载 - Layer 3: 知识沉淀 (.ai/knowledge/) — 决策/模式/教训自动积累 新增： - DASHBOARD.md — 人类仪表盘（30秒了解全貌） - ROADMAP.md — 任务看板+阻塞追踪 - docs/share/ — 对外分享内容层（一鸡多吃） - docs/使用手册.md — 人+AI使用手册 - .ai/prompts/architecture/ — 补充缺失的架构提示词 - .ai/principles.md — 信息架构设计原则 - review/active/INDEX.md — 任务索引 修改： - AGENTS.md: 239行→117行，顶部AI跳转 - README.md: 精简聚焦人类读者 - PROJECT_CONTEXT.md: 精简+分层说明 - DECISIONS.md: 替换为跳转存根 - 5个task.md: 添加phase字段 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1.3 KiB
1.3 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 自己更新完成状态
反模式（避免）
- 在多个文件中重复同一状态信息 → 只在 ROADMAP.md 记录
- 决策讨论散落在任务 feedback 中 → 提炼到 knowledge/decisions.md
- 大段文档内联而非链接 → 用链接 + 一句话摘要