用途:对一次编码会话做回顾,目标是改进编码智能体的运行环境,让后续运行更顺畅。若用户未指定会话,默认回顾当前会话。
主要能力:先加载 writing-for-agents 技能(读取其 SKILL.md)获取写作风格指南;再读取指定会话的一手资料,可用 pi-session-search 技能在 ~/.pi/agent/sessions 的 JSONL 上做 UTF-8 安全查询,替代临时的 grep/python 单行命令。随后从以下类别寻找改进候选:导航(文件查找是否困难、是否存在隐藏依赖、是否需要导航指针);自动化检查(lint、类型检查、测试、文件系统 linter,先读仓库自身的 check 命令,如 package.json 或构建工具的 lint/check 脚本、CI 工作流,避免重复造轮子;无任何护栏本身即为发现);编码标准(先分类违规:机械性违规应做确定性检查,如自定义 lint 规则、pre-commit 钩子或 CI 任务,默认建检查而非写规则,CODING_STANDARDS.md 只留给真正的判断类问题);全局 AGENTS.md(是否应把引导指令移到编码标准或自动化检查);工具经济性(昂贵或低效的工具调用、token 效率差的 CLI 或 MCP);空操作(不改变智能体行为的指令);信息获取(如 tee 开发服务器日志、第三方服务只读访问)。最后按严重程度向用户呈现候选。
参考要点:工作分实现与审查两阶段,实现智能体上下文压力最大,负责探索、写代码、调试;审查智能体上下文压力最小,只收到 diff,通常无需探索或调试,因此编码标准应由审查智能体负责施加。仓库文件方面:CLAUDE.md/AGENTS.md 会进入任何在该仓库工作的智能体上下文,应极少使用,通常只放指向其他文件的导航指针;CODING_STANDARDS.md 在审查时读取,超过 1000 行时加导航指针;docs 作为被其他文件指向的参考文件,先找现有文档;skills 用于文档或用户调用的命令,并遵循 writing-for-agents 的建议。
限制:资料未提供具体安装命令、收费、平台支持或效果数据,暂未提供。