harvest 用于复盘 AI 智能体的会话记录,找出会话偏离 moo 标准的流程,并把它们整理成开发者可直接处理的问题报告。它只负责捕获与报告,不负责起草、构建或修复技能,修复由开发者依据报告完成。
用途:对照 moo 的标准——智能体只在说明意图与形态时提问,随后自主工作——检查一次会话在哪些地方没有做到,并把每个偏离整理成可操作的 issue 或对已有 issue 的补充评论。
主要能力:
- 读取会话:运行 read.sh <id>,<id> 取 $ARGUMENTS,否则取 ${CLAUDE_SESSION_ID};失败时显示错误并停止。其输出是唯一来源,引用的轮次必须是其中编号的轮次;长文本会被截断,可用 read.sh <id> <turn> 完整打印某一轮。
- 检测偏离:读取 kinds 目录下每个文件,每个文件描述一种会话偏离标准的方式,包括标记轮次中的迹象、何为符合、何为不符合、所需证据。对每种方式遍历轮次,收集满足条件且带有所需证据的流程;缺乏证据的流程会被丢弃而非猜测,但会先完整读取其引用的被截断轮次。
- 命名机会:每个流程归入以下之一——已有技能覆盖该需求且明确要求该动作(引用其 SKILL.md 中丢失的那一行);存在覆盖该需求的技能但未被选中(指出技能及本应触发它的轮次用词);已有技能覆盖但对该动作沉默或含糊(指明改进该技能);没有已安装的 moo 技能覆盖(新建技能);用户多次给出的步骤(可复用片段)。需先查看 read.sh 打印的已安装列表,已安装技能能覆盖的需求不得提议新建。
- 评估价值:指出修复服务于 moo 四项成果中的哪一项——减少决策遗憾、提升概念清晰度、更少但更强的产物、保留对自己产出的掌控能力;都不符合则丢弃该流程。
- 匹配历史 issue:运行 past.sh(失败则显示错误并停止),列出所有 harvest issue 及其评论中关于重开的说明;若某流程的需求已被列出的 issue 以任何措辞表达,则作为该 issue 的新案例而非新 issue,判定前需完整阅读该 issue。
- 起草:每个新流程一个 issue 文件,每个匹配流程一个评论文件,分别按 issue.md 和 comment.md 模板排版;只从 read.sh 轮次中引用用户原话;仓库、文件、服务、人员或远程位置处使用占位符。
- 脱敏:对每份草稿运行 scrub.sh <id> <draft>,退出码为 1 时替换其列出的每个词并重跑;未通过的草稿不得展示。
- 展示与提交:按证据权重排序展示每个流程(引用轮次最多、迹象最清晰者优先),附完整草稿及文件路径,评论还需说明所加入的 issue 及是否重开;随后询问报告者要提交哪些。仅对报告者明确同意的草稿执行提交:新 issue 用 gh issue create 并带 harvest 标签,标题取草稿首行;评论用 gh issue comment,并在其 Reopen 部分满足条件时用 gh issue reopen。展示每个 URL;同意后修改过的草稿需重新走脱敏与展示。
使用方式:需在具备 read.sh、past.sh、scrub.sh 脚本及 kinds、issue.md、comment.md 模板的技能目录环境中运行,并具备对 saadshahd/moo.md 仓库的 gh 访问权限。具体安装与调用命令资料未提供。
限制:不提议在已有安装技能覆盖需求时新建单元;不为历史 issue 已表达的需求新建 issue;不编写代码或技能文件;未经报告者对确切文本的同意不提交。