refactor(architecture): 信息架构重构 — 从"人类导向单体文档"到"AI优先分层架构"

新增四层信息架构： - 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>
2026-05-25 16:49:36 +08:00
parent 5dfc382c55
commit 4184a6d0b5
65 changed files with 1642 additions and 582 deletions
@@ -0,0 +1,6 @@
+# 架构提示词模板
+
+| 文件 | 用途 |
+|------|------|
+| `architecture-design.md` | 系统架构设计模板 |
+| `technical-evaluation.md` | 技术选型评估模板 |
@@ -0,0 +1,44 @@
+# 系统架构设计模板
+
+## 输入
+
+- 产品需求文档 (PRD)
+- 技术约束（已有技术栈、团队能力）
+- 非功能性需求（性能、安全、可扩展性）
+
+## 输出结构
+
+### 1. 架构概述
+- 一句话描述架构核心思路
+- 系统边界和范围
+
+### 2. 架构图（文字描述 + ASCII）
+- 模块划分和职责
+- 模块间通信方式
+- 数据流向
+
+### 3. 技术选型
+- 每个模块的技术栈及理由
+- 对比方案及淘汰原因
+- 风险点和缓解措施
+
+### 4. 接口设计
+- 模块间接口定义
+- API 契约（请求/响应格式）
+- 数据模型概要
+
+### 5. 非功能性设计
+- 性能目标及实现策略
+- 安全设计（认证、授权、数据保护）
+- 可扩展性考虑
+
+### 6. 部署架构
+- 运行环境
+- 服务拓扑
+- CI/CD 流程
+
+## 注意事项
+
+- 架构文档面向 Arch AI 和 Dev AI，不要写人类才需要的背景介绍
+- 决策必须写理由，方便后续 AI 理解为什么这样设计
+- 每个模块标注影响范围（HIGH/MEDIUM/LOW），供 QA AI 确定回归测试范围
@@ -0,0 +1,41 @@
+# 技术选型评估模板
+
+## 输入
+
+- 需要解决的技术问题
+- 约束条件（预算、时间、团队、已有技术栈）
+
+## 输出结构
+
+### 1. 需求描述
+- 要解决什么问题
+- 关键约束是什么
+
+### 2. 候选方案（2-4 个）
+
+每个方案描述：
+- 方案名称和简介
+- 优势（3-5 条）
+- 劣势（3-5 条）
+- 与本项目技术栈的兼容度
+
+### 3. 评估维度
+
+| 维度 | 权重 | 方案A | 方案B | 方案C |
+|------|------|-------|-------|-------|
+| 性能 | 30% | — | — | — |
+| 生态成熟度 | 25% | — | — | — |
+| 学习曲线 | 20% | — | — | — |
+| 社区活跃度 | 15% | — | — | — |
+| 团队熟悉度 | 10% | — | — | — |
+| **加权总分** | 100% | — | — | — |
+
+### 4. 推荐方案
+- 推荐哪个、为什么
+- 主要风险
+- 如果失败，备选方案是什么
+
+## 注意事项
+
+- 评估维度可调整，但必须说明理由
+- 不追求"最优"，追求"最适合当前阶段"