liu-zhengdong/pi-shadow-mind

解决的问题

Pi Shadow Mind 解决了主 AI 代理偏离架构标准、对代码库事实性错误或在实现功能时未能维护文档的问题。通过引入专门的、持久的「认知核心」，在主代理执行的同时并行审查和验证工作，防止昂贵的错误。

工作原理

该系统与主代理并行运行专门的代理（Shadow Minds）。这些 Shadow 由 Markdown 文件定义，并分配特定职责，例如架构审查或项目基础设定。

它们根据触发条件激活：「心跳」（主代理调用工具后以概率激活）或「最终响应」（主代理完成任务后激活）。激活后，Shadow 会与主代理轨迹的清理版本启动临时会话。然后判断当前工作是否与其角色相关；若是，则可使用分配的工具检查项目，并通过 report_to_main 函数将发现结果返回给主代理。

适用人群

使用 Pi 代理框架的开发者，希望在不手动审查每一步的情况下，确保高质量的代码架构、准确的文档以及严格遵守项目约束。

亮点

• 持久角色：与临时任务不同，Shadow Minds 是用户定义的角色，可独立决定何时介入。
• 可配置激活：支持概率性心跳触发和保证的最终响应检查。
• 细粒度工具访问：每个 Shadow 可被限制为只读访问，或分配特定工具以执行并行工作。
• 模型过滤：可根据配置，为不同模型分配不同的支持性心智。