mcpField
P
paperclip-record-strategy

paperclip-record-strategy

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

关于 paperclip-record-strategy

paperclip-record-strategy 用于创建或选择 Paperclip 规划链，关联目标、项目、父事项和计划文档。它会检查现有上下文，并在修改前征求批准。

主要功能

  1. 01检查现有目标和项目
  2. 02确定缺失的规划关联
  3. 03起草规划链
  4. 04修改 Paperclip 前征求批准
  5. 05创建或更新计划文档

适用场景

  1. 01将已确认的说明整理为计划
  2. 02将项目关联到合适的目标
  3. 03创建附有策略计划的父事项

MCP 相关

当 CLI 缺少所需操作时，此技能使用专用 Paperclip MCP 工具；对于 CLI 和专用工具未提供的原生字段，则使用 paperclipApiRequest。

安装

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

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

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

包含的文件

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

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

详细介绍

Paperclip 记录策略

创建或选择缺失的 Paperclip 规划链：

Goal tree -> linked Project -> Parent Issue + plan document

参考资料

请先阅读：

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

如果缺少这些项目文档，请先运行 paperclip-setup，以 bundled templates 为基础生成这些文档。

流程

  1. 确认已有获批的澄清摘要。
  2. 检查当前的 Paperclip 上下文和公司。
  3. 使用 integration-matrix.md 中的 CLI 优先阶梯，列出已有目标和项目。
  4. 与操作员确认这是以下哪一种：
    • 新建根目标或子目标
    • 现有目标
    • 在现有目标下新建项目
    • 现有项目
    • 在现有项目下新建父级 Issue
  5. 起草提议的规划链。
  6. 在修改 Paperclip 前征求批准。
  7. 仅创建或更新获批的缺失部分。
  8. 报告生成的 Goal、Project、父级 Issue，以及计划文档链接或标识符。

Wiki 源材料

如果获批的澄清摘要或操作员提示中引用了 Paperclip wiki URL、wiki 页面路径或已捕获的 wiki 源材料，请在起草规划链或计划文档前使用 paperclip-wiki-fetch。如有相关信息，请在计划的来源说明中记录获取到的页面标题、路径、更新时间和哈希，然后将 Markdown 正文用作源材料。

如果缺少 wiki 凭据、公司范围、wiki id、空间 slug 或页面路径，且无法从 Paperclip 上下文中推断，请停止并询问缺少的信息，不要根据未获取的 wiki 引用起草内容。

如果操作员明确要求将生成的策略内容发布或同步到 wiki，请先完成 Paperclip 规划链提案，然后使用 paperclip-wiki-manage 修改 wiki。不要默认用 wiki 替代父级 Issue 的 plan 文档作为事实来源。

Goal 字段

Paperclip Goal 具有原生的 level、status、parentId 和 ownerAgentId 字段。不要将此结构简化为标题。

默认映射：

  • company：用于公司层面的长期成果。如果目标是公司的北极星目标，优先使用有效的根级公司目标。
  • team：用于团队、职能、业务推进、渠道、领域或策略方面的长期子目标。将 parentId 设为父级公司或团队目标。
  • agent：仅在特定 Paperclip Agent 负责该目标时使用。设置 ownerAgentId。
  • task：很少使用。对于营销活动、月份、冲刺、潜在客户名单、草稿工作和可执行任务，优先使用 Issue。

每项拟议的 Goal 修改都必须在审批前展示 title、level、status、parentId 和 ownerAgentId。

界面规则

选择工具前，请先阅读 integration-matrix.md。

对于此技能：

  • 优先使用 CLI，前提是它支持所需的原生字段并能验证结果。
  • 当 CLI 不支持该操作，或需要进行脆弱的解析时，使用专用 Paperclip MCP 工具。
  • 如果存在原生的 paperclipai goal create/update、project create/update 和 issue 命令，且其 JSON 回读能验证所需字段，则使用这些命令。
  • 仅当已安装的 CLI 或专用 MCP 工具未提供原生字段时，才使用 MCP paperclipApiRequest。
  • 仅当 CLI 和 MCP 不可用或已损坏时，才直接使用 REST。
  • 对于父 Issue 的 plan，使用键控 issue 文档；如果存在 paperclipai issue document:get、document:put 和 document:revisions，优先使用这些命令，然后再使用 MCP 文档工具。

首次发出 MCP API 请求或直接执行 REST 修改前：

  1. 通过 paperclipai context show --json 推导出 apiBase 和 companyId。
  2. 运行 paperclipai auth whoami --json，确认当前使用的身份验证来源。
  3. 如有需要，在不打印机密的前提下，检查 ~/.paperclip/auth.json 中存储的看板凭据结构。
  4. 确认目标读取路径可用后再写入。

绝不打印 bearer token。如果无法推导身份验证信息，请停止操作，并向操作人员索取所需上下文，不要降低策略产物的要求。

策略计划文档

如果支持，请使用父 issue 的 plan 文档作为策略产物。

建议的计划结构：

## Outcome

## Why This Matters

## Success Criteria

## Scope

## Non-Goals

## Constraints

## Risks

## Autonomy Level

## Validation

## Stop Conditions

## Planning Notes

如果可用，请使用 paperclipai issue document:put <issueId> plan --body-file <path> --json。更新时，先读取当前文档并传入其基础修订 ID，确保过期写入会失败并返回 409 Conflict。如果 CLI 无法写入键控文档，请使用 MCP 文档工具。如果没有可用的专用 MCP 工具，请使用 paperclipApiRequest，并说明所采用的路径。只有在 CLI、MCP 和 API 均不可用，或操作人员明确拒绝使用它们时，才将计划嵌入父 issue 描述，作为最后手段。

修改规则

创建或更新 Paperclip 前，务必先展示拟议的 Goal、Project、Parent Issue 和计划正文。

评论

支持 Markdown