设计原则

本地与远程

端侧 Agent 可以读取本地工作区，也可以通过网络调用项目资源工具。Subagent 用于并行调查，不替代直接工具调用。

契约优先

• 组件只通过版本化协议协作。
• MCP 是工具接口，不是业务主状态。
• 能力只定义一次，多个入口共同调用。
• 所有破坏性变化必须有迁移、兼容和回滚方案。

证据优先

不同事实使用不同权威来源：进度看 DevOps，逻辑看目标提交代码，运行状态看数据库与日志，文档用于理解需求背景。