paperclip-converting-plans-to-tasks

paperclip-converting-plans-to-tasks

Paperclip 将计划转化为可执行任务的方式。当你在 Paperclip 公司内被要求进行计划、范围界定或分解工作时使用。关于如何将计划转化为具有正确专业、依赖关系和并行化的已分配问题的行业无关指南,以便 Paperclip 的执行者能够接手工作——它不规定计划格式。与 `paperclip` 技能配合使用,该技能涵盖编写计划文档和重新分配问题的机制。

1Star
0Fork
更新于 2026/7/10
SKILL.md
readonly只读
name
paperclip-converting-plans-to-tasks
description

The Paperclip way of converting a plan into executable tasks. Use whenever you are asked to plan, scope, or break down work inside a Paperclip company. Industry-agnostic guidance on how to translate a plan into assigned issues with the right specialty, dependencies, and parallelization so Paperclip's executor can pick up the work — it does not prescribe a plan format. Pair with the `paperclip` skill, which covers the mechanics of writing the plan document and reassigning the issue.

Paperclip — 将计划转化为任务

这是一个辅助技能,用于将计划转化为可执行的 Paperclip 工作。它规定计划结构——你可以使用任何适合工作和用户偏好的格式。它告诉你_如何_将计划转化为问题,以便 Paperclip 的其他部分为你工作。

关于记录计划的机制(包含键 plan 的问题文档、评论链接、审批门控、重新分配给谁),请遵循 paperclip 技能的_计划_部分。本技能涵盖计划方法,而非 API 接口。如果 Paperclip 尚未安装,请先阅读 skills/paperclip/references/setup-installation.md

当你被要求制定计划时

  • 深入计划。 尽可能多地捕捉真实细节:目标、约束、未知因素、成功标准、风险。浅显的计划会导致下游返工——执行者只能根据他们能读到的内容行动。
  • 了解你的团队。 在分配任何任务之前,查看公司的代理及其专业领域(汇报关系、角色描述、先前工作)。当存在更合适的代理时,不要默认将工作分配给自己;不要分配给你未核实过的名字。
  • 按专业分配。 将每项工作分配给最相关的代理。如果没有合适的人选,要明确指出——需要招聘、工具、外部依赖、董事会决策——而不是掩盖缺口。
  • 承担责任。 专业匹配是双向的:当_你_是某项工作的最佳人选时,将其分配给自己,而不是条件反射地委派他人。不要为了避免负担而转交工作。
  • 使用依赖树。 Paperclip 的执行者会自动启动任何没有未解决阻塞的任务。父/子问题嵌套是结构,而非执行阻塞。将每个具体的可交付成果表示为一个问题,并通过 blockedByIssueIds 在依赖问题上连接计划中的每个硬依赖(而不是像“被 X 阻塞”这样的文字描述)。当阻塞达到 done 状态时,依赖项会自动唤醒。
  • 排序,然后并行化。 根据实际依赖关系安排工作顺序,而不是个人偏好。图中的独立分支应并行启动。与人类不同,大多数代理允许并发运行,因此你可以将并行工作分配给同一个代理。
  • 适可而止。 计划的存在是为了推动执行,而不是取代执行。如果下一步很小且明确,就直接去做,或者让计划自行成立。重新计划一个计划,或者将一个代理在分解工作所需时间内就能完成的工作拆分,是拖延行为——交付一些东西。

当将已接受的计划转化为任务时

在创建任务之前或同时,编写一个紧凑的任务矩阵,包含每个计划任务、负责人、初始状态和阻塞项。任何可以立即开始的任务都应说明为什么没有阻塞;否则将其设置为 blocked,并在 blockedByIssueIds 中包含前置问题的 ID。不要依赖 parentId、子排序、阶段标签或文字描述来阻塞执行。

创建任务后,重新获取已创建的问题或以其他方式验证问题图,然后再将源计划问题标记为完成。确认每个依赖任务具有预期的 blockedByIssueIds,每个独立任务有明确的“可以立即开始”的原因,并且父/子层次结构仅用于可追溯性。如果预期的阻塞缺失,报告不匹配,并将计划问题保留在 in_reviewblocked 状态,直到任务图被纠正。

发布计划前的快速检查清单

  • [ ] 足够的细节,使执行者无需再次询问即可行动。
  • [ ] 每个具体的可交付成果都是一个问题(或作为已知的后续事项命名)。
  • [ ] 每个问题都有经过深思熟虑的、专业匹配的负责人——而不是默认的计划制定者。
  • [ ] 每个问题的真实阻塞通过 blockedByIssueIds 声明。
  • [ ] 紧凑的任务矩阵列出了计划任务、负责人、初始状态和阻塞项。
  • [ ] 没有阻塞的任务有明确的理由可以立即开始。
  • [ ] 在关闭源计划问题之前,已重新获取或以其他方式验证了创建的问题。
  • [ ] 独立分支可以并行启动。
  • [ ] 缺口(缺失的技能、招聘、决策、外部输入)被公开,而不是隐藏。

本技能不是什么

  • 不是计划模板。使用任何格式——散文、大纲、表格、RACI、甘特图等。
  • 不是软件开发专属。同样的规则适用于市场、研究、运营、设计、招聘、财务等。
  • 不是 paperclip 技能计划机制的替代品。两者都使用。