spec-architecture-strategist
You are a System Architecture Expert specializing in analyzing code changes and system design decisions.
ASCII 调度图
text
plan / work / review specialist phase
|
v
selector: task stage + risk domain + evidence gap
|
v
spec-architecture-strategist
|
v
structured findings / research notes / specialist advice
|
v
orchestrator synthesis + user-visible decision基本信息
| 字段 | 内容 |
|---|---|
| Agent | spec-architecture-strategist |
| 类型 | Architecture |
| 归属 skill | spec-plan |
| 复用次数 | 1 个 skill |
| Source | skills/spec-plan/references/agents/architecture-strategist.md |
什么时候会被调用
- 架构边界、可维护性、agent readiness、模式一致性或过度设计风险需要专项判断。
- 通常由上层 workflow 选择调用;它不是用户直接执行的
spec-*workflow 入口。 - 当任务证据不足、风险域明确或需要独立专家视角时,才应该引入该 agent。
Source 角色摘要
You are a System Architecture Expert specializing in analyzing code changes and system design decisions. Your role is to ensure that all modifications align with established architectural patterns, maintain system integrity, and follow best practices for scalable, maintainable software systems.
Source 章节
- Planning Invocation Contract
输入
- 目标、相关源码、计划、diff、项目规则和可复用模式证据。
- 上层 workflow 应提供明确 scope、相关文件或文档、当前假设和需要回答的问题。
- 如果依赖 graph、MCP、浏览器或外部资料,需要同时说明 provider readiness 与 degraded 状态。
输出
- 架构判断、反模式、简化建议、agent 可达性缺口或可维护性风险。
- 输出应返回给 orchestrator 汇总,而不是绕过主 workflow 直接改变最终结论。
- 对 findings、风险和建议应标注证据边界,避免把推测写成确定事实。
使用边界
- 不把抽象本身当成目标;必须回到当前项目和 workflow 的真实增益。
- Agent 是专业判断角色,不是 tool,也不是固定状态机。
- 如果当前问题可以由 deterministic script、测试或 provider status 直接确认,应优先使用确定性证据。
与 workflow 的关系
- Skills 定义入口、步骤和产物;agents 提供局部专家判断。
- 当前 agent 的 runtime copy 由
spec-first init在目标项目中选择宿主后从 source 生成。 - 不要手改
.claude/agents或.codex/agents作为 source;需要修复 runtime drift 时重新运行 init。
源码校准
- 本页由
website/scripts/generate-agent-detail-pages.js从skills/spec-plan/references/agents/architecture-strategist.md生成。 - 上游 agent 现为 skill-local prompt 资产(
skills/<skill>/references/agents/*.md),无 frontmatter;名称取自文件名,description 由生成器从 prompt 首段启发式提取。 - 分组是官网生成器的用户手册视角,用于解释调度场景;精确角色指令仍以 source agent 文件为准。
阅读下一步
- 归属 skill:
spec-plan - Agents 参考:按 skill 归属查看 26 个 agents
- Skills 参考:查看 workflow 入口与 skill 详情页
- Code Review 指南:理解 reviewer personas 如何进入 review gate
