mcpField
P
paperclip-triage

paperclip-triage

github.com/bbengaminAgent 工作流354 次安装11 周前更新
代码仓库

关于 paperclip-triage

paperclip-triage 用于审查 Paperclip 事项，判断其是否适合进入 AFK Agent 循环，并规定检查项、分类和经批准后的变更流程。

主要功能

  1. 01事项就绪度检查
  2. 02八种分诊分类
  3. 03提出具体变更建议
  4. 04变更前征求批准
  5. 05核验已批准的更新

适用场景

  1. 01判断事项是否可交由 Agent 执行
  2. 02找出缺失条件或阻塞项
  3. 03检查父事项及子任务

MCP 相关

当 CLI 无法完成操作时，此技能会使用 Paperclip MCP 事项工具或 paperclipApiRequest 执行更新并核验。

安装

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

$npx skills add https://github.com/bbengamin/skills --skill paperclip-triage

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

包含的文件

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

references/
CONTEXT.md
references/docs/paperclip-operator/
afk-readiness.md
cli-contract.md
control-plane.md
integration-matrix.md

详细介绍

Paperclip 分类审查

判断 Paperclip 问题是否足够完善，可以进入 AFK Agent 循环。

参考资料

常规分类审查请先阅读以下资料：

  • references/CONTEXT.md
  • references/docs/paperclip-operator/afk-readiness.md
  • references/docs/paperclip-operator/integration-matrix.md

仅当问题涉及相应领域时，才打开其余参考资料：

  • references/docs/paperclip-operator/control-plane.md，了解实体语义、父子结构、阻塞项、评论、文档、审批和活动。
  • references/docs/paperclip-operator/cli-contract.md，了解 CLI/REST 身份验证、回退示例和变更验证。

如果缺少这些项目文档，请先运行 paperclip-setup，根据随附模板创建文档。

流程

  1. 阅读目标问题或问题列表。

  2. 对于每个问题，检查：

    • 状态
    • 项目
    • 父项
    • 描述
    • 验收标准
    • 阻塞项和 blockedByIssueIds
    • 计划文档
    • 评论
    • 负责人（如有）
    • 如果需要审查，检查 executionPolicy.stages[].participants 中的审查关卡
    • 是否需要人工最终验收；如果需要，审查 Agent 必须负责一个幂等的 request_confirmation 交接，而不是用户审批阶段
    • 在建议更改任何分配之前，检查正在运行、排队中和重试中的运行
    • 预期执行者的默认环境和项目工作区；除非操作者要求，否则不要建议覆盖设置

  3. 将范围内的每个问题恰好归入以下一类：

    • AFK-ready
    • needs-info
    • blocked
    • needs-human
    • too-broad
    • revise
    • cancel
    • done

    完成条件：范围内的每个问题都恰好有一个分类。

  4. 建议具体的更改。完成条件：每个非 AFK-ready 问题都明确指出使其达到就绪状态所缺少的要素或所需变更。

  5. 等待批准。

  6. 应用已批准的更改。

Wiki 源材料

如果就绪情况取决于 Paperclip wiki URL、wiki 页面路径或已捕获的 wiki 源材料，请使用 paperclip-wiki-fetch 验证源是否可访问且内容是否充分，然后再将问题归为 AFK-ready。如有相关信息，请在建议中附上获取到的标题、路径、更新时间和哈希值。

如果由于缺少凭据、公司范围、wiki id、空间 slug 或页面路径而无法获取 wiki 参考资料，请将问题归为 needs-info，并在“缺少的就绪要素”中指出缺少的 wiki 访问信息。

如果分类审查发现 wiki 内容过时、缺失或不正确，请建议后续使用 paperclip-wiki-manage 技能。除非操作者明确切换到 wiki 管理并批准确切的变更，否则不要在常规分类审查中修改 wiki 内容。

范围深度

分类审查父问题时，请检查其直接子项。如果操作者提到“子任务”、出现新规划的子项，或就绪判定取决于孙项，则再检查一层子项。默认不要递归遍历大型树；请概述更深层的分支，并建议对仍是规划父项的子项使用 paperclip-plan-work。

建议格式

## Triage Recommendation

### <issue identifier/title>

- Classification:
- Current status:
- Recommended status:
- Missing readiness elements:
- Proposed comment:
- Proposed blocker links:
- Proposed reviewer gate:
- Proposed human confirmation:
- Follow-up skill:

对于大型问题树，请使用紧凑模式：

## Triage Recommendation

- Parent summary:
- Executable now:
- Blocked:
- Needs planning/info:
- Approved mutations table:

状态规则

  • todo 表示已就绪且可执行。
  • backlog 表示暂缓处理或尚不可启动。
  • 对于具体的问题依赖，blocked 必须使用一等公民字段 blockedByIssueIds。评论可以说明负责人和解除阻塞的操作，但除非操作者明确批准降级模式，否则不能替代阻塞项链接。
  • 对于范围过大的问题，请使用 paperclip-plan-work。
  • 使用评论说明分类审查理由。

变更规则

先报告建议。只有在操作者批准后，才能更新状态、评论、阻塞项、标签、负责人或审查关卡。

应用已批准的更改

使用能够执行原生变更的最精简 Paperclip 接口：

  • 如果 CLI 支持所需字段并能验证结果，请优先使用 CLI 读取、更新和评论 issue。
  • 如果 CLI 无法执行或验证操作，请使用 MCP issue 工具。
  • 对于 CLI 和专用 MCP 工具未公开的 Paperclip 原生字段，请使用 MCP paperclipApiRequest，尤其是 blockedByIssueIds 和 executionPolicy。
  • 只有在 CLI 和 MCP 不可用或无法正常工作时，才直接使用 REST。

每次变更后都要重新读取 issue 进行验证。对于阻塞关系变更，请确认返回的 issue 包含预期的 blockedByIssueIds；除非操作人员明确批准降级模式，否则不能把仅有评论说明视为等效结果。对于审核者门禁，请确认返回的 issue 包含预期的 executionPolicy.stages[].participants；除非目标环境已验证映射关系，否则不能把 reviewRequest 视为等效结果。

如果当前 issue 详情界面未显示评论历史，请检查可用的活动记录／评论界面。如果仍无法读取评论，请在建议中说明这一限制，并根据可见的 issue 字段继续处理，而不要因此阻塞整个分类工作。

当已批准的分类工作包含委派时，请在 issue 未分配期间完成 issue 摘要、阻塞关系、评论、状态和审核者门禁。确认不存在正在运行或待重试的运行，然后仅在最后一步变更中分配执行者。分配唤醒任务入队后，停止进行变更，并将观察工作交给 paperclip-monitor。不要覆盖执行者的常规环境，不要调用 heartbeat/resume，不要提及执行者，也不要添加后续评论，除非操作人员提供了实质性的新必需信息。

评论

支持 Markdown