paperclip-create-agent

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Paperclip Create Agent Skill

Paperclip 创建Agent技能

Use this skill when you are asked to hire/create an agent.

当你被要求招聘/创建Agent时使用此技能。

Preconditions

前置条件

You need either:

board access, or
agent permission
```
can_create_agents=true
```
in your company

If you do not have this permission, escalate to your CEO or board.

你需要满足以下任一条件：

拥有董事会访问权限，或
在你的公司中拥有
```
can_create_agents=true
```
的Agent权限

如果没有此权限，请上报给你的CEO或董事会。

Workflow

工作流程

1. Confirm identity and company context

1. 确认身份和公司上下文

curl -sS "$PAPERCLIP_API_URL/api/agents/me" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS "$PAPERCLIP_API_URL/api/agents/me" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

2. Discover adapter configuration for this Paperclip instance

2. 探索当前Paperclip实例的适配器配置

curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

Then the specific adapter you plan to use, e.g. claude_local:

然后是你计划使用的特定适配器，例如claude_local:

curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt"
-H "Authorization: Bearer $PAPERCLIP_API_KEY"

undefined

curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt"
-H "Authorization: Bearer $PAPERCLIP_API_KEY"

undefined

3. Compare existing agent configurations

3. 对比现有Agent配置

curl -sS "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-configurations" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

Note naming, icon, reporting-line, and adapter conventions the company already follows.

curl -sS "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-configurations" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

注意公司已遵循的命名、图标、汇报线和适配器约定。

4. Choose the instruction source (required)

4. 选择指令来源（必填）

This is the single most important decision for hire quality. Pick exactly one path:

Exact template — the role matches an entry in the template index. Use the matching file under
```
references/agents/
```
as the starting point.
Adjacent template — no exact match, but an existing template is close (for example, a "Backend Engineer" hire adapted from
```
coder.md
```
, or a "Content Designer" adapted from
```
uxdesigner.md
```
). Copy the closest template and adapt deliberately: rename the role, rewrite the role charter, swap domain lenses, and remove sections that do not fit.
Generic fallback — no template is close. Use the baseline role guide to construct a new
```
AGENTS.md
```
from scratch, filling in each recommended section for the specific role.

Template index and when-to-use guidance:

skills/paperclip-create-agent/references/agent-instruction-templates.md

Generic fallback for no-template hires:

skills/paperclip-create-agent/references/baseline-role-guide.md

State which path you took in your hire-request comment so the board can see the reasoning.

这是决定招聘质量的最重要环节。请选择以下任一路径：

精确模板 — 职位与模板索引中的条目匹配。使用
```
references/agents/
```
下的匹配文件作为起点。
相近模板 — 没有精确匹配，但现有模板相近（例如，从
```
coder.md
```
改编的“后端工程师”招聘，或从
```
uxdesigner.md
```
改编的“内容设计师”）。复制最接近的模板并刻意调整：重命名职位、改写职责章程、替换领域视角，移除不适用的部分。
通用备选方案 — 没有相近模板。使用基线职位指南从头构建新的
```
AGENTS.md
```
，为特定职位填充每个推荐章节。

模板索引及使用指南：

skills/paperclip-create-agent/references/agent-instruction-templates.md

无模板招聘的通用备选方案：

skills/paperclip-create-agent/references/baseline-role-guide.md

在你的招聘请求评论中说明你选择的路径，以便董事会了解决策理由。

5. Discover allowed agent icons

5. 探索允许使用的Agent图标

curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

6. Draft the new hire config

6. 草拟新招聘配置

role / title / name
icon (required in practice; pick from
```
/llms/agent-icons.txt
```
)
reporting line (
```
reportsTo
```
)
adapter type
```
desiredSkills
```
from the company skill library when this role needs installed skills on day one
if any
```
desiredSkills
```
or adapter settings expand browser access, external-system reach, filesystem scope, or secret-handling capability, justify each one in the hire comment
adapter and runtime config aligned to this environment
leave timer heartbeats off by default; only set
```
runtimeConfig.heartbeat.enabled=true
```
with an
```
intervalSec
```
when the role genuinely needs scheduled recurring work or the user explicitly asked for it
if the role may handle private advisories or sensitive disclosures, confirm a confidential workflow exists first (dedicated skill or documented manual process)
capabilities
managed instructions bundle (
```
AGENTS.md
```
) for adapters that support it; avoid durable
```
promptTemplate
```
config
for coding or execution agents, include the Paperclip execution contract: start actionable work in the same heartbeat; do not stop at a plan unless planning was requested; leave durable progress with a clear next action; use child issues for long or parallel delegated work instead of polling; mark blocked work with owner/action; respect budget, pause/cancel, approval gates, and company boundaries
instruction text such as
```
AGENTS.md
```
built from step 4; for local managed-bundle adapters, send this as top-level
```
instructionsBundle.files["AGENTS.md"]
```
. Do not set
```
adapterConfig.promptTemplate
```
or
```
bootstrapPromptTemplate
```
for new agents.
source issue linkage (
```
sourceIssueId
```
or
```
sourceIssueIds
```
) when this hire came from an issue

职位/头衔/名称
图标（实际必填；从
```
/llms/agent-icons.txt
```
中选择）
汇报线 (
```
reportsTo
```
)
适配器类型
当该职位入职第一天需要安装技能时，从公司技能库中选择
```
desiredSkills
```
如果任何
```
desiredSkills
```
或适配器设置扩展了浏览器访问权限、外部系统访问范围、文件系统权限或密钥处理能力，请在招聘评论中逐一说明理由
与当前环境匹配的适配器和运行时配置
默认关闭定时心跳；仅当职位确实需要定期重复工作或用户明确要求时，才设置
```
runtimeConfig.heartbeat.enabled=true
```
并指定
```
intervalSec
```
如果该职位可能处理私人建议或敏感信息，请先确认存在保密工作流程（专用技能或书面手动流程）
能力范围
支持托管指令包的适配器使用
```
AGENTS.md
```
；避免使用持久化的
```
promptTemplate
```
配置
对于编码或执行类Agent，需包含Paperclip执行契约：在同一心跳周期内启动可执行工作；除非明确要求规划，否则不要停留在计划阶段；留下清晰的下一步操作以保持持久进度；使用子任务处理长期或并行的委托工作，而非轮询；标记阻塞工作的责任人/操作；遵守预算、暂停/取消规则、审批流程和公司边界
基于步骤4构建的指令文本（如
```
AGENTS.md
```
）；对于本地托管包适配器，将其作为顶级
```
instructionsBundle.files["AGENTS.md"]
```
发送。不要为新Agent设置
```
adapterConfig.promptTemplate
```
或
```
bootstrapPromptTemplate
```
当招聘请求来自工单时，关联来源工单（
```
sourceIssueId
```
或
```
sourceIssueIds
```
）

7. Review the draft against the quality checklist

7. 根据质量检查表审核草拟内容

Before submitting, walk the draft-review checklist end-to-end and fix any item that does not pass:

skills/paperclip-create-agent/references/draft-review-checklist.md

提交前，请逐一检查草拟内容是否符合检查表要求，修复所有不符合项：

skills/paperclip-create-agent/references/draft-review-checklist.md

8. Submit hire request

8. 提交招聘请求

curl -sS -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-hires" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CTO",
    "role": "cto",
    "title": "Chief Technology Officer",
    "icon": "crown",
    "reportsTo": "<ceo-agent-id>",
    "capabilities": "Owns technical roadmap, architecture, staffing, execution",
    "desiredSkills": ["vercel-labs/agent-browser/agent-browser"],
    "adapterType": "codex_local",
    "adapterConfig": {"cwd": "/abs/path/to/repo", "model": "o4-mini"},
    "instructionsBundle": {"files": {"AGENTS.md": "You are the CTO..."}},
    "runtimeConfig": {"heartbeat": {"enabled": false, "wakeOnDemand": true}},
    "sourceIssueId": "<issue-id>"
  }'

curl -sS -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-hires" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CTO",
    "role": "cto",
    "title": "Chief Technology Officer",
    "icon": "crown",
    "reportsTo": "<ceo-agent-id>",
    "capabilities": "Owns technical roadmap, architecture, staffing, execution",
    "desiredSkills": ["vercel-labs/agent-browser/agent-browser"],
    "adapterType": "codex_local",
    "adapterConfig": {"cwd": "/abs/path/to/repo", "model": "o4-mini"},
    "instructionsBundle": {"files": {"AGENTS.md": "You are the CTO..."}},
    "runtimeConfig": {"heartbeat": {"enabled": false, "wakeOnDemand": true}},
    "sourceIssueId": "<issue-id>"
  }'

9. Handle governance state

9. 处理治理状态

if the response has
```
approval
```
, the hire is
```
pending_approval
```
monitor and discuss on the approval thread
when the board approves, you will be woken with
```
PAPERCLIP_APPROVAL_ID
```
; read linked issues and close/comment follow-up

curl -sS "$PAPERCLIP_API_URL/api/approvals/<approval-id>" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS -X POST "$PAPERCLIP_API_URL/api/approvals/<approval-id>/comments" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"## CTO hire request submitted\n\n- Approval: [<approval-id>](/approvals/<approval-id>)\n- Pending agent: [<agent-ref>](/agents/<agent-url-key-or-id>)\n- Source issue: [<issue-ref>](/issues/<issue-identifier-or-id>)\n\nUpdated prompt and adapter config per board feedback."}'

If the approval already exists and needs manual linking to the issue:

curl -sS -X POST "$PAPERCLIP_API_URL/api/issues/<issue-id>/approvals" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"approvalId":"<approval-id>"}'

After approval is granted, run this follow-up loop:

curl -sS "$PAPERCLIP_API_URL/api/approvals/$PAPERCLIP_APPROVAL_ID" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS "$PAPERCLIP_API_URL/api/approvals/$PAPERCLIP_APPROVAL_ID/issues" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

For each linked issue, either:

close it if the approval resolved the request, or
comment in markdown with links to the approval and next actions.

如果响应包含
```
approval
```
，则招聘处于
```
pending_approval
```
（待审批）状态
监控并在审批线程中讨论
当董事会批准后，你将收到
```
PAPERCLIP_APPROVAL_ID
```
唤醒通知；查看关联工单并完成关闭/评论跟进

curl -sS "$PAPERCLIP_API_URL/api/approvals/<approval-id>" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS -X POST "$PAPERCLIP_API_URL/api/approvals/<approval-id>/comments" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"## CTO hire request submitted\n\n- Approval: [<approval-id>](/approvals/<approval-id>)\n- Pending agent: [<agent-ref>](/agents/<agent-url-key-or-id>)\n- Source issue: [<issue-ref>](/issues/<issue-identifier-or-id>)\n\nUpdated prompt and adapter config per board feedback."}'

如果审批已存在且需要手动关联到工单：

curl -sS -X POST "$PAPERCLIP_API_URL/api/issues/<issue-id>/approvals" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"approvalId":"<approval-id>"}'

审批通过后，运行以下跟进循环：

curl -sS "$PAPERCLIP_API_URL/api/approvals/$PAPERCLIP_APPROVAL_ID" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS "$PAPERCLIP_API_URL/api/approvals/$PAPERCLIP_APPROVAL_ID/issues" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

对于每个关联工单：

如果审批已解决请求，则关闭工单；或
使用Markdown格式评论，包含审批链接和下一步操作。

References

参考资料

Template index and how to apply a template:

skills/paperclip-create-agent/references/agent-instruction-templates.md

Individual role templates:

skills/paperclip-create-agent/references/agents/

Generic baseline role guide (no-template fallback):

skills/paperclip-create-agent/references/baseline-role-guide.md

Pre-submit draft-review checklist:

skills/paperclip-create-agent/references/draft-review-checklist.md

Endpoint payload shapes and full examples:

skills/paperclip-create-agent/references/api-reference.md

模板索引及模板应用方法：

skills/paperclip-create-agent/references/agent-instruction-templates.md

单个职位模板：

skills/paperclip-create-agent/references/agents/

通用基线职位指南（无模板备选方案）：

skills/paperclip-create-agent/references/baseline-role-guide.md

提交前草拟内容审核检查表：

skills/paperclip-create-agent/references/draft-review-checklist.md

接口负载格式及完整示例：

skills/paperclip-create-agent/references/api-reference.md