SuperAPI AI 工具集

harness-3-retro

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:这是 harness 循环(Boot → Backpressure Check → Do Work and Observe → Retro and Magic Wand → Improve)中 Retro 阶段的技能,把工作中观察到的摩擦转化为可执行知识,而非易腐坏的文档。

主要能力:两种模式。--drain 在会话结束或逻辑暂停时读取 docs/harness/_buffers/<agent>.session-buffer.md,展示软提示菜单 [s/t/p/e/d/a],把条目写入 .retro.md,或生成 /plan-5 --fix、/plan-1b 调用,或把编码改动暂存为 scratch/encode-<id>-<target>.diff(不自动应用,需人工 git apply)。--harvest 扫描 docs/harness/agents/**/.retro.md 及旧路径 docs/retros/.md,按 retro_id 去重、校验 schema、聚类并按复现次数、严重度、反向压力杠杆与时间排序,打印前 10 个开放簇;支持 --json、--plan、--agent、--since、--kind 过滤及 --prune --older-than 的干跑清理。

使用方式:手动运行 /harness-3-retro --drain 或 --harvest;也可由流水线技能在自然暂停点自动触发。存在 docs/harness/.disabled 时静默禁用。

适用场景:会话收尾沉淀改进、跨会话整理待办、把重复摩擦编码为 justfile 配方或技能编辑。

限制:不中途提示、不自动应用 diff、不编辑已写 .retro.md、不跨会话聚合(由 --harvest 负责);编码 diff 必须附 Validation 页脚;陈旧阈值仅为提示,不强制变更。