Gentleman-Programming/gentle-pi

解决的问题

许多 AI 编码代理的失败并非源于模型的智能不足，而是由于操作纪律薄弱。常见问题包括在需求不明确时就直接编写代码、在聊天记录中丢失架构决策、创建过大的拉取请求，以及忽视测试。gentle-pi 通过强制执行工程严谨性和结构化工作流，将 Pi 编码代理转变为受控的开发环境。

工作原理

它在 Pi 中安装了一个名为 el Gentleman 的「资深架构师」操作层。该层引入了规范驱动开发（SDD）和 OpenSpec，确保大型或高风险变更必须遵循初始化、设计和验证的严格流程。系统根据复杂度路由任务：小规模修改保持内联处理，上下文密集的探索任务委派给专注的子代理，而架构变更则触发 SDD 流程。

为保证质量，它实现了严格的 TDD（测试驱动开发）支持，要求记录完整的 RED → GREEN → TRIANGULATE → REFACTOR 循环证据。同时集成了经过验证的原生运行时，阻止破坏性 shell 命令并保护敏感文件路径。

适用人群

希望超越简单聊天式编码，迈向具有可审查工作单元和架构防护机制的严谨、专业工程环境的 Pi 编码代理使用者。

主要亮点

• 规范驱动开发（SDD）： 提供结构化的阶段代理链（初始化、设计、任务、验证等），用于处理复杂变更。
• 子代理编排： 通过将探索和实现任务委派给专业子代理，保持父会话轻量化。
• uma 技能发现注册表： 维护项目和用户技能注册表，确保任务由合适的专业能力执行。
• 严格的 TDD 证据： 当项目配置要求时，强制记录测试驱动开发周期。
• 运行时安全： 包含经过验证的原生运行时，可阻止破坏性命令和敏感路径访问。