mcpField
Y
yak-shaving-triage

yak-shaving-triage

github.com/sakana-yAgent 工作流246 次安装今天更新
代码仓库

关于 yak-shaving-triage

yak-shaving-triage 是一项 Agent 技能,用于保持工程任务聚焦,同时跟踪独立发现。它保存证据、协调评估与记录核对,并避免旁支工作挤占已授权任务。

主要功能

  1. 01保持已授权任务的范围
  2. 02记录有证据支持的旁支观察
  3. 03协调评估与记录核对
  4. 04跟踪待处理事项和阻碍
  5. 05暂停或停止时保留检查点
  6. 06区分工作记录与问题发布

适用场景

  1. 01记录实现期间发现的独立问题
  2. 02不打断主任务地保留未决线索
  3. 03将发现与现有记录核对
  4. 04任务结束时移交发现与阻碍

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/sakana-y/skills --skill yak-shaving-triage

安装后在 Claude Code 中输入/yak-shaving-triage确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
background-reconciliation.md
discovery-lenses.md
issue-capture.md

详细介绍

Yak Shaving 分流

全面留意。解决当前问题。保留其他内容。

从工程任务开始,无论该任务是由模型还是用户选择的。后续调用会加入当前任务。持续处理,直到用户问题解决,或用户停止此技能。用户问题是当前获授权的目标及边界;其工作流负责必要的调查、实施和验证。常规工作只需静默检查,无需反复汇报范围。

使用随 investigate-with-evidence 安装的 Assess Findings,进行资格判定、关联分析和建议。复用 Just 或 Explore 中已有的评估。若缺少依赖,则暂缓判断,同时继续可行的主要工作。

1. 建立记录机制并守住下一分支

阅读工作记录约定,以确定用户选择的仓库、项目身份、保存/提交权限及现有记录布局。复用已有配置;如果缺少目标位置,只询问一次,同时继续主要任务。在问题解决前,保留因该阻碍而未保存的观察结果。只有在当前任务的历史记录门槛允许时,才读取先前的发现。设置是可选的,不会自动调用。

将每条具体线索或考虑中的任务切换与用户问题进行比较。使用 Just 时,遵循其声明的批次:在该批次中保留必要调查,并将独立的新目标留待后续处理。剩余的旁支发现不会延长批次,也不会妨碍其结束。必要的调查或修复仍属于主要工作流,所需深度不限。独立观察结果可以在最终评估前记录;没有具体证据的怀疑只能作为备注,不能确认为发现。使用发现视角,对未解决的线索进行有限检查,或开展用户明确要求的探索。复用已经足够的证据。

在适当的检查点,将独立观察结果及其证据保存到配置的记录中,或向其协调者返回更新。将事实、假设、当前评估和实施进度分别记录。清理临时内容前,先保存关键证据。工作记录不是正式问题单:问题单记录负责判断是否适合建单、协调规范记录及发布到跟踪系统。

**完成条件:**每个分支都属于主要任务、已有保存或明确待处理的观察记录,或基于明确的证据理由予以排除。继续主要任务。

2. 评估并协调,避免重复工作

使用共享的协调方法。协调者根据任务适配度,选择直接处理或安排有明确范围的工作者,而不是要求每个角色都配备单独的 Agent。发现工作者检查一条具体线索;评估负责人判断发现及其关联;协调工作者搜索现有记录和实现覆盖情况。这些分工关注的问题各不相同,并会复用已有结果。任何一方都不会独自修复旁支问题或发布该问题。

在研究规范跟踪器之前,先检查搜索资格。符合资格且可以在主任务继续期间独立搜索时,使用后台协调。否则,在合适的检查点执行范围明确的搜索,或记录保留该工作的原因和下一步操作。已关闭的关卡同样适用于工作者。在关卡发生变化、任务恢复和任务完成时,重新检查待办工作。

评估负责人负责判断行动价值并建议优先级;Yak 负责记录身份、协调处置、报告排序和经批准的跟踪器发布。将重要搜索结果和交付覆盖情况返回给同一位评估者;根据返回的信息修订受影响的判断,而不是重新执行整个评估。对于已确认的发现,通过评估流程请求建议优先级,并保留其量表和限制。相关问题可能有共同原因,但仍可保持各自独立的验收边界。

在历史记录访问权限开放时,按照工作记录约定协调 PR 链接。已知的远程状态是带日期的观察结果,并非永久事实。缺少跟踪器指南会阻止正式协调,但不会阻止经授权的工作记录捕获;保留草稿,并将规范目标位置问题推迟到任务完成时处理。

**完成条件:**每项符合资格的发现都有负责人和结果,或有待办原因及下一步操作;共享记录反映已返回的证据;常规旁支工作没有挤占用户问题。

3. 收尾并交接

报告主任务的实际状态,收回已分派的工作,并重新检查待办发现。对于无成效的规范搜索,以“协调受阻”结束,并说明其限制。根据结果报告约定呈现发现,将已确认的缺陷、机会和未解决的观察结果分别列出。展示已记录的路径、保存或提交失败情况,以及规范匹配结果。

对于正式的跟踪器变更,展示准确的草稿,并依据问题捕获流程获取跟踪器写入批准。复用现有记录无需变更。缺少规范指南时,先收集一个目标位置问题,再进行协调,然后再提议写入。经授权的工作记录可以保留证据和待处理的跟踪器草稿,但这并不表示内容已发布。

暂停或停止时,应立即停止派发工作和受影响的工作者,保留检查点,并移交或清理所拥有的资源。仅停止 Yak 不会改变主工作流的现有权限。恢复时应依据已记录的状态和继承的证据关卡继续,而不是重复已完成的搜索。后续证据支持归档或重新开启时,按照工作记录生命周期处理;PR 合并本身并不能决定验收结果。

**完成条件:**任务状态、每项观察结果的评估和持久化状态、符合资格的协调结果或受阻原因,以及每项经批准的跟踪器变更的实际结果,都清晰且可恢复。

紧急发现

对于可信的安全、数据丢失或破坏性风险,应立即通知用户,停止可能导致风险发生的操作,并保留已脱敏的证据。继续遵守独立性关卡和跟踪器发布要求。只有在用户授权后,修复才能纳入任务范围。

评论

支持 Markdown