用途：分析 Pi 会话，发现重复模式与工具失败，进而改进智能体行为。目标包括模式发现（找出重复的提示词/工作流）和失败分析（识别反复出现的工具错误）。
主要能力与输出：可生成多步工作流（agent/skills/<name>/）、带参数的单一提示词（agent/prompts/<name>.md）、危险模式拦截或确认（agent/extensions/guardrails/defaults.json）、改动后自动格式化/检查（agent/extensions/hooks/defaults.json）、项目专属规则（AGENTS.md）以及通用智能体宣言（agent/APPEND_SYSTEM.md）。
会话工具：pi-list-projects、pi-list-sessions --project "my-project" --limit 10 用于列出项目/会话；pi-tool-calls、pi-tool-calls --errorsOnly、pi-tool-calls --tool "bash:jj" --days 7 用于分析工具调用；pi-session-events --days 30 --limit 200、pi-session-events --query "refactor" --days 30 用于搜索事件；pi-read-session --session 0、pi-read-session --session 0 --role toolResult --query "error" 用于读取会话。
工作流：先收集数据（pi-session-events --days 30 --limit 200；pi-tool-calls --errorsOnly --days 7），再识别重复提示词（常见动词如 create、refactor、describe、split，结构相似但部分可变，多步工作流）与工具失败（Edit 报 "Could not find exact text"，Bash 中 grep 退出码 1、jj 语法错误等），然后按频率（30 天内出现 3 次以上）、复杂度（需 5 次以上工具调用）、易错性、重复性排序，最后创建改进。
常见失败修复：Edit 报 "Could not find" 时先读文件再用更小编辑；报 "No changes made" 时确认内容确有差异；Bash 中 grep 退出码 1 可用 grep ... || true；jj 报 "ambiguous" 或 "^ is not" 时用 @- 表示父提交。
输出格式：技能为 agent/skills/<name>/SKILL.md；提示词模板以 --- 开头定义 name、args（含 description、default），正文用 {{param}} 占位；护栏为含 pattern、action、reason 的 JSON；钩子为含 event、pattern、command 的 JSON。APPEND_SYSTEM.md 新章节使用罗马数字编号标题并带 Against 或 For 立场，散文段落，不用列表、加粗或缩进块，第一人称陈述，通用原则，添加前先读现有章节并匹配风格。
限制：资料未提供安装方式、收费、平台支持或效果数据。