mcpField
P
paperclip-plan-work

paperclip-plan-work

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

关于 paperclip-plan-work

用于为 Paperclip 父级事项制定下一层子事项方案的技能。它对候选事项分类，并仅在获批后将其创建为未分配的 backlog 事项，不启动执行。

主要功能

  1. 01读取父事项及相关上下文
  2. 02仅提出一层子事项
  3. 03为每个子事项分类
  4. 04获批后创建 backlog 事项
  5. 05核验关联和事项字段

适用场景

  1. 01将策略事项拆分为子事项
  2. 02在执行前整理依赖关系
  3. 03创建获批且未分配的 backlog 结构

安装

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

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

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

包含的文件

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

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

详细介绍

Paperclip 计划工作

每次只规划一层子问题。不要生成完全展开的多层问题树。

规划不等于执行。此技能可以判断拟议的子问题是否看起来已准备好供后续分流，但不得让它们进入可开始状态。创建计划问题时，应将状态设为 backlog，且不指派负责人，除非操作者明确切换到 paperclip-triage 或委派工作流。

参考资料

请先阅读以下文件：

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

如果缺少这些项目文档，请先运行 paperclip-setup，使用随附模板生成文档。

流程

  1. 确定父策略问题或父问题。

  2. 阅读问题、父级链、项目、计划文档、阻塞项和评论。

  3. 执行 Paperclip 环境预检。

  4. 提出一层子问题。

  5. 将每个拟议子问题准确归入以下一种类型：

    • 看起来已准备就绪
    • 规划父问题
    • 需要人工处理
    • 已阻塞
    • 需要补充信息

    完成条件：每个拟议子问题都恰好具有一种类型。

  6. 如果有两个以上拟议子问题属于“需要人工处理”“已阻塞”“需要补充信息”或“宽泛的规划父问题”，请暂停创建问题，先进行有针对性的问答／深入讨论。

  7. 列出每个问题将写入的确切标题、正文、状态、父级、项目、目标、阻塞项链接和负责人。

  8. 展示拟议的拆分方案并征求批准。

  9. 获得批准后，按依赖顺序创建问题。

  10. 对于规划父问题，询问是否要对每个问题再进行一轮规划。

Wiki 源材料

如果父问题、计划文档、评论或操作者提示中引用了 Paperclip wiki URL、wiki 页面路径或已捕获的 wiki 源材料，请在提出子问题前使用 paperclip-wiki-fetch。如果获取到的相关源材料标题、路径、更新时间、哈希和证明片段会影响工作，则将其纳入拟议问题正文或验收标准。

如果因缺少凭据、公司范围、wiki id、空间标识或页面路径而无法获取 wiki 引用，请暂停规划并询问缺少的信息。不要创建依赖于无法访问的 wiki 材料的子问题。

如果操作者明确要求从规划结果发布、同步或更新 wiki 内容，请先完成拟议拆分方案，然后在获得批准后使用 paperclip-wiki-manage 修改 wiki。

环境预检

在提出任何变更前，确认以下内容可写：

  • 当前公司及公司 id
  • 创建／更新问题
  • 子问题的父级关联
  • 问题状态更新，仅用于将计划工作保持在 backlog
  • blockedByIssueIds
  • 计划文档读写（涉及计划文档时）
  • 如果 CLI 和专用 MCP 工具无法写入所需的原生字段，则确认 MCP API 请求或直接 REST 是否可用

仅使用 paperclipai context show --json、paperclipai auth whoami --json 和 ~/.paperclip/auth.json 获取 API 连接详情。切勿打印 bearer token。如果无法写入必需的原生字段，请停止并报告缺少的能力。除非操作者明确批准降级模式，否则不要用评论替代一等阻塞项、父级链接或计划文档。

拟议拆分格式

## Proposed Child Issues

### 1. <title>

- Type: ready-looking | planning parent | needs-human | blocked | needs-info
- Priority:
- Status to write: backlog
- Parent:
- Project:
- Goal:
- Blocked by:
- Assignee: null
- Body:
- Acceptance criteria:
- Validation:
- Stop conditions:

创建规则

  • 规划只会创建 backlog 状态且未分配的议题。
  • 不要通过此技能创建或更新 todo、分配 Agent、检出工作或手动调用心跳。
  • 将 todo 视为处于活跃操作状态；它可能会触发任务领取。只有 paperclip-triage 或明确的委派工作流才能将规划中的工作移至 todo。
  • 尊重操作员的意图：“plan”、“break down”或“create the structure”表示创建待办结构，而非执行工作。
  • 将规划父议题创建为 backlog 状态。
  • 使用 parentId 或当前界面的原生父级字段，将子议题关联到父议题。如果使用 MCP，请确认所公开的工具架构，并验证父级关联已保留在创建的记录中。
  • 如果可用，优先使用 paperclipai issue child:create <parentIssueId> --payload-json <json> --json，因为命令中明确指定了父议题。继续操作前，请验证返回的子议题及其父级关联。
  • 对于 blockedByIssueIds，请使用 MCP paperclipApiRequest，除非 CLI 或专用 MCP 议题工具公开并能验证该字段。
  • 不要将任何通过规划创建的议题分配给执行 Agent。
  • 如有帮助，请添加评论说明规划决策。

变更事务规范

Paperclip 当前的操作界面未提供明显的多议题事务功能。创建多个议题时：

  1. 创建一个议题。
  2. 立即验证：
    • parentId 与预期的父议题一致
    • projectId 与目标项目一致
    • goalId 已继承或正确关联
    • status 为 backlog
    • 负责人为空
    • 预期存在的 blockedByIssueIds 关联已建立
  3. 尽可能通过 CLI、MCP、paperclipApiRequest 或直接 REST 修复结构不匹配问题。
  4. 不要将规划议题修改为 todo；应将看似已准备就绪的议题报告为待分流候选项。
  5. 仅在验证成功后，才继续创建下一个议题。

如果无法正确设置父级关联、阻塞项关联、项目关联、目标关联、backlog 状态或空负责人，请在创建剩余议题前停止，并报告部分完成状态。

变更规则

操作员批准拟议的拆分方案之前，绝不要创建子议题。

评论

支持 Markdown