用途：loop-finder 面向使用 AI 编程智能体的用户，通过分析历史对话发现重复出现的“循环”，并把这些循环固化为可实施的工作流规格。
主要能力分六个阶段。一、发现会话：按优先级查找 ~/.pi/agent/sessions/、~/.codex/sessions/、~/.claude/sessions/ 或 ~/.claude/projects/、~/.opencode/ 或 ~/.config/opencode/、~/.hermes/ 下的 *.jsonl 等会话文件；用户指定智能体时只查该智能体；若完全找不到，则询问用户聊天历史存放位置。二、提取用户消息：先读每个文件前几行判断 JSONL 结构再解析，只取用户消息文本，忽略系统消息、工具调用和助手回复，并对语义相同或相近的消息去重（如连续多次“继续”算一个模式），最后报告读取的会话数、用户消息数与工作区数。三、识别循环：穷尽分析重复指令、“继续”链、回退/撤销、工具链维护（update/upgrade/sync/install）、多步骤任务等信号，对每个候选项输出名称、带证据的模式描述、出现次数和自动化 ROI（高/中/低），并要求所有出现 3 次以上的模式不被遗漏。四、向用户提议：列出候选循环并询问要设计哪一个，或选“all”。五、追问规格：一次只问一个问题，每个问题附带基于历史观察的推荐答案，等待回答后再问下一个；术语包括触发（事件或定时，事件通常更高效）、检查点、尽量后置检查点、简报（决策就绪的紧凑摘要，而非原始输出）；完成标准是实施者智能体无需再提问即可构建。六、写出产物：在当前工作区写入 workflows/[workflow-name].md（规格来源）并追加 NOTES.md；若智能体支持系统指令文件，则追加核心规则到 pi 的 ~/.pi/agent/AGENTS.md、Codex 的 ~/.codex/AGENTS.md、Claude Code 的 ~/.claude/CLAUDE.md 或项目级 CLAUDE.md；未知或不支持的智能体则跳过该步，并告知规格所在位置以便手动复制。
限制与约束：不硬编码任何智能体路径，先搜索、找不到再问用户；检测而非假定 JSONL 格式；只写入当前使用的智能体的指令文件，不假定安装了全部智能体；若当前智能体没有系统指令机制，跳过写入但告知规格位置。具体安装方式、收费与价格信息暂未提供。