Agency：构建接近自主的AI编程代理工作流

本文介绍srid/agency项目，这是一个将AI编程代理工作流打包为APM包的创新方案，通过/do和/talk等命令实现从研究到PR的全自动流水线。

Agency是一个为编码代理设计的近自主工作流框架，以APM包的形式分发。它定义了一套标准化的命令和流程，使AI代理能够在人类监督下自主完成复杂的开发任务。

项目的核心理念是：将最佳实践编码化为可自动执行的流程，同时保留人类在关键决策点的介入能力。这种"放手但可控"的模式，代表了AI辅助开发的新范式。

Agency围绕两个主要命令构建：

这是Agency的旗舰功能。执行/do命令后，AI代理将自动完成以下完整流程：

1. 研究（Research）：分析需求，探索实现方案
2. 架构评估（Hickey）：使用Rich Hickey的"Simple Made Easy"框架评估结构简单性
3. 模块分解审查（Lowy）：基于Juval Lowy的框架检查模块边界是否封装了变化轴
4. 分支创建：在版本控制中创建功能分支
5. 代码实现：根据研究结论编写代码
6. 质量检查（Code Police）：三阶段质量门——规则检查、事实核查、优雅度审查
7. CI验证：运行持续集成流程
8. PR生成（Forge PR）：编写开发者真正想读的PR标题和描述

整个过程无需人工干预，直到最后的PR审查阶段。

与/do不同，/talk是一个纯对话模式。代理可以讨论想法、探索方案、阅读代码，但不允许修改文件。这适用于需求澄清、架构讨论、代码审查等场景，让开发者在动手编码前充分思考。

Agency的一个关键设计决策是将复杂任务分解为专门的子代理，而不是在单一对话循环中串行执行。这种架构带来了显著优势：

以Rich Hickey的著名演讲"Simple Made Easy"为理论基础，hickey子代理专门负责识别代码中的意外复杂性。它检查：

• 是否存在不必要的耦合（complecting）
• 模块职责是否清晰分离
• 是否有更简单的替代方案

重要的是，hickey作为独立子代理运行，可以与lowy并行执行，而不需要在主对话循环中串行等待。

lowy子代理基于Juval Lowy的《Righting Software》框架（继承自Parnas 1972年的模块化标准），检查模块边界是否封装了变化轴而非仅仅是功能。

核心问题是：当需求变化时，哪些模块需要修改？理想情况下，变化应该被隔离在最小范围的模块内。