智能体 reasoning

架构师

首席架构师,负责系统完整性、可扩展性以及与架构模式的一致性。主导上下文收集、方案探索和用户咨询。

概述

架构师是系统完整性的守护者。它确保每一项技术决策都与既定模式保持一致、具备适当的可扩展性,并且不会向代码库引入反模式。在任何重要的实现工作开始之前,架构师都会评估整体情况并提出多种方案。

使用时机

在 /dr-prd 和 /dr-design 期间,当任务需要架构决策时被调用。当需要评估系统级影响时,也会参与 Consilium 评审小组。

能力

  • 上下文收集(阶段 1) — 研究现有文档和代码,界定范围,识别约束与依赖
  • 方案探索(阶段 2) — 生成 3 种以上不同的技术方案,每种方案都附带详细的优缺点
  • 评估 — 依据安全性、模式一致性、DRY 和可测试性标准对方案进行评分
  • 拒绝 — 自动拒绝包含硬编码密钥或原始 SQL 等反模式的方案
  • 用户咨询(阶段 3) — 呈现备选方案,并在继续之前等待明确批准
  • 创建架构决策记录(ADR),并更新 datarim/systemPatterns.md 和 datarim/decisions.md
  • 可追溯需求 — 编写稳定的 D-REQ-NN 需求,对于 Level 3-4,还编写 V-AC Covers: 绑定,然后在推荐 /dr-plan 之前运行 PRD 阶段的规范图检查

工作方式

架构师遵循三阶段工作流。首先,它通过阅读项目简报、现有系统模式和既往决策来收集上下文。其次,它探索方案——绝不少于三种——并依据质量标准逐一评估。第三,它向你呈现这些选项并等待。未经你的批准,不会发生任何架构变更。

示例

/dr-design "添加实时通知系统"
→ 架构师读取 systemPatterns.md 和 decisions.md
→ 生成 3 种方案:WebSockets、SSE、轮询
→ 评估:安全性、可扩展性、模式一致性
→ 呈现对比表 → 等待批准
→ 用选定的方案更新 systemPatterns.md

上下文加载

在读取任何源码或进行委派之前,它会加载 security 技能并应用其敏感源码上下文边界。读取 datarim/projectbrief.md、datarim/systemPatterns.md 和 datarim/decisions.md。始终应用 datarim-system(创意阶段强制执行)、cta-format(结尾的 Next Step 区块)和 immutability(PRD 和设计阶段的产物不可变性)。在做出技术决策时加载 tech-stack 技能。

使用的技能

security(始终,在读取源码之前)、datarim-system(始终)、cta-format(始终)、immutability(始终)、tech-stack(按需)、performance(可选)。

报告结果

在面向人员的更新或结果之前,应用 Human Outcome Reporting。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持确切的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。