关于 yak-shaving-triage
yak-shaving-triage 是一项 Agent 技能,用于保持工程任务聚焦,同时跟踪独立发现。它保存证据、协调评估与记录核对,并避免旁支工作挤占已授权任务。
主要功能
- 01保持已授权任务的范围
- 02记录有证据支持的旁支观察
- 03协调评估与记录核对
- 04跟踪待处理事项和阻碍
- 05暂停或停止时保留检查点
- 06区分工作记录与问题发布
适用场景
- 01记录实现期间发现的独立问题
- 02不打断主任务地保留未决线索
- 03将发现与现有记录核对
- 04任务结束时移交发现与阻碍
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sakana-y/ skills --skill yak-shaving-triage安装后在 Claude Code 中输入/yak-shaving-triage确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/background-reconciliation.mddiscovery-lenses.mdissue-capture.md详细介绍
Yak Shaving 分流
全面留意。解决当前问题。保留其他内容。
从工程任务开始,无论该任务是由模型还是用户选择的。后续调用会加入当前任务。持续处理,直到用户问题解决,或用户停止此技能。用户问题是当前获授权的目标及边界;其工作流负责必要的调查、实施和验证。常规工作只需静默检查,无需反复汇报范围。
使用随 investigate-with-evidence 安装的 Assess Findings,进行资格判定、关联分析和建议。复用 Just 或 Explore 中已有的评估。若缺少依赖,则暂缓判断,同时继续可行的主要工作。
1. 建立记录机制并守住下一分支
阅读工作记录约定,以确定用户选择的仓库、项目身份、保存/提交权限及现有记录布局。复用已有配置;如果缺少目标位置,只询问一次,同时继续主要任务。在问题解决前,保留因该阻碍而未保存的观察结果。只有在当前任务的历史记录门槛允许时,才读取先前的发现。设置是可选的,不会自动调用。
将每条具体线索或考虑中的任务切换与用户问题进行比较。使用 Just 时,遵循其声明的批次:在该批次中保留必要调查,并将独立的新目标留待后续处理。剩余的旁支发现不会延长批次,也不会妨碍其结束。必要的调查或修复仍属于主要工作流,所需深度不限。独立观察结果可以在最终评估前记录;没有具体证据的怀疑只能作为备注,不能确认为发现。使用发现视角,对未解决的线索进行有限检查,或开展用户明确要求的探索。复用已经足够的证据。
在适当的检查点,将独立观察结果及其证据保存到配置的记录中,或向其协调者返回更新。将事实、假设、当前评估和实施进度分别记录。清理临时内容前,先保存关键证据。工作记录不是正式问题单:问题单记录负责判断是否适合建单、协调规范记录及发布到跟踪系统。
**完成条件:**每个分支都属于主要任务、已有保存或明确待处理的观察记录,或基于明确的证据理由予以排除。继续主要任务。
2. 评估并协调,避免重复工作
使用共享的协调方法。协调者根据任务适配度,选择直接处理或安排有明确范围的工作者,而不是要求每个角色都配备单独的 Agent。发现工作者检查一条具体线索;评估负责人判断发现及其关联;协调工作者搜索现有记录和实现覆盖情况。这些分工关注的问题各不相同,并会复用已有结果。任何一方都不会独自修复旁支问题或发布该问题。
在研究规范跟踪器之前,先检查搜索资格。符合资格且可以在主任务继续期间独立搜索时,使用后台协调。否则,在合适的检查点执行范围明确的搜索,或记录保留该工作的原因和下一步操作。已关闭的关卡同样适用于工作者。在关卡发生变化、任务恢复和任务完成时,重新检查待办工作。
评估负责人负责判断行动价值并建议优先级;Yak 负责记录身份、协调处置、报告排序和经批准的跟踪器发布。将重要搜索结果和交付覆盖情况返回给同一位评估者;根据返回的信息修订受影响的判断,而不是重新执行整个评估。对于已确认的发现,通过评估流程请求建议优先级,并保留其量表和限制。相关问题可能有共同原因,但仍可保持各自独立的验收边界。
在历史记录访问权限开放时,按照工作记录约定协调 PR 链接。已知的远程状态是带日期的观察结果,并非永久事实。缺少跟踪器指南会阻止正式协调,但不会阻止经授权的工作记录捕获;保留草稿,并将规范目标位置问题推迟到任务完成时处理。
**完成条件:**每项符合资格的发现都有负责人和结果,或有待办原因及下一步操作;共享记录反映已返回的证据;常规旁支工作没有挤占用户问题。
3. 收尾并交接
报告主任务的实际状态,收回已分派的工作,并重新检查待办发现。对于无成效的规范搜索,以“协调受阻”结束,并说明其限制。根据结果报告约定呈现发现,将已确认的缺陷、机会和未解决的观察结果分别列出。展示已记录的路径、保存或提交失败情况,以及规范匹配结果。
对于正式的跟踪器变更,展示准确的草稿,并依据问题捕获流程获取跟踪器写入批准。复用现有记录无需变更。缺少规范指南时,先收集一个目标位置问题,再进行协调,然后再提议写入。经授权的工作记录可以保留证据和待处理的跟踪器草稿,但这并不表示内容已发布。
暂停或停止时,应立即停止派发工作和受影响的工作者,保留检查点,并移交或清理所拥有的资源。仅停止 Yak 不会改变主工作流的现有权限。恢复时应依据已记录的状态和继承的证据关卡继续,而不是重复已完成的搜索。后续证据支持归档或重新开启时,按照工作记录生命周期处理;PR 合并本身并不能决定验收结果。
**完成条件:**任务状态、每项观察结果的评估和持久化状态、符合资格的协调结果或受阻原因,以及每项经批准的跟踪器变更的实际结果,都清晰且可恢复。
紧急发现
对于可信的安全、数据丢失或破坏性风险,应立即通知用户,停止可能导致风险发生的操作,并保留已脱敏的证据。继续遵守独立性关卡和跟踪器发布要求。只有在用户授权后,修复才能纳入任务范围。