Pi Shadow Mind：代码审计者身份与并行认知核心

一句话：主 Agent 持续推进实现；若干 Shadow Mind 按固定职责并行审阅、核验或维护，在返工成本变高之前介入。

项目介绍

Pi Shadow Mind 让多个专业化认知核心与主 Agent 并行工作。每个 Shadow Mind 都有一项持续、稳定的职责，例如架构审阅、正确性检查、文档维护、项目事实核验，或任何由你定义的任务。

主 Agent 负责持续推进；其他认知核心独立审阅决策、核验事实、维护相关文件，并在错误演变成高昂返工之前介入。

让实现与审阅发生在同一轮工作中。

认知核心	职责
架构审阅	在编码过程中发现上帝组件、职责错位、模块边界缺失和脆弱的扩展点
项目事实核验	对照真实仓库检查结论，发现模型编造的 API、文件、约束和实现细节
文档维护	跟踪实现变化，让架构说明、设计决策和使用文档保持同步
完成度审阅	在主 Agent 宣布完成前，独立检查结果是否真正满足任务要求

这些职责由用户定义、持续存在，可以独立决定何时检查、行动或汇报；主 Agent 不会临时把它们当作一次性子任务派出去。

Shadow Mind 可以保持只读，只向主 Agent 汇报发现；也可以获得额外工具，独立负责另一条任务线。

主 Agent 写代码时，另一个 Shadow 可以同步维护文档、更新架构决策，或处理独立文件。工具权限按每个 Shadow 单独配置，每个认知核心只拿到职责真正需要的能力。

主 Agent                 Architecture Shadow
实现功能                 审阅模块边界

主 Agent                 Documentation Shadow
编写代码                 维护设计文档

审阅只是职责之一。Shadow Mind 可以观察、核验、维护，也可以直接构建。

默认配置下，这个 Shadow 只读：在实现过程中并行审阅架构，并向主 Agent 报告具体问题，不接管主任务。

发现问题后，Shadow 回报给主 Agent，由主 Agent 接着处理，不会直接改主任务。

流程大致是：

Shadow 调用 report_to_main({ content: "..." })，当前 Shadow 会话立刻结束。
报告进入短暂聚合窗口（默认约 400ms），多个 Shadow 的意见可合并成一份。
插件生成可见的 shadow-report，再按主 Agent 状态投递：
- 主 Agent 仍在运行：用 steer，插到下一个认知边界；
- 主 Agent 空闲：用 follow-up，触发补充或纠正。
主 Agent 看到报告后，自己决定改代码、解释，还是忽略。
主 Agent 回复的 turn_end 可能再次唤醒 Shadow，形成审阅链。用户发来新消息后进入新 epoch，旧的 Shadow 与未投递报告失效。

Shadow 回报主 Agent 的交接流程

要点：Shadow 只指出问题；真正怎么修，仍由主 Agent 执行。超时、中止或用户开了新一轮时，未投递的结果会丢掉，不会硬插进新任务。

Pi 把 AgentSession 做成可被扩展调用的运行时原语；Cursor 把它收进产品内核，只对外暴露受控边界。因此这套 Shadow Mind 目前只能在 Pi 上落地。