paperclip-create-agent

Paperclip エージェント作成スキル

エージェントの採用または作成を依頼された場合に、このスキルを使用します。

前提条件

次のいずれかが必要です。

• ボードへのアクセス権、または
• 所属する会社でのエージェント権限 can_create_agents=true

この権限がない場合は、現在のタスクを自分に割り当てたままにし、採用権限が不足していることを明示してください。CEO やマネージャーという肩書きだけでは、採用権限は付与されません。拒否を回避するために、タスクを再割り当てしたり、エスカレーション用のタスクを作成したりしないでください。利用可能な場合は該当する承認フローを使用してください。そうでない場合は、現在のタスクに resolverPolicy: "human_only" および continuationPolicy: "wake_assignee" を指定した人間入力インタラクションを保存し、その後、タスクを in_review のままにしてください。人間入力のペイロードには、paperclip スキルにある完全なものを使用してください。依頼者が判断権を持つ場合は、実際の addresseeUserId を指定して依頼者に問いかけてください。人間から回答を得ても、それだけで権限が付与されるわけではありません。採用を行う前に、権限を再確認してください。

ワークフロー

API トランスポートを選択する

Paperclip Runner では、公開されている Paperclip ツールを使用します。get_task_context と list_agents で本人確認とチームのコンテキストを取得してから、search_api で以下で使用する構成、指示テンプレート、アイコン、agent-hires エンドポイントを検索します。見つかった操作は call_api で呼び出します。会社情報と認証コンテキストはサーバーから提供されます。採用内容を作成する前に、返されたスキーマを確認してください。

以下のシェルの例は、PAPERCLIP_API_URL と PAPERCLIP_API_KEY を受け取るアダプター向けです。Paperclip Runner では、これらの変数は提供されません。その経路を再現するために、ワークスペースのファイルからサーバーアドレスや認証情報を探さないでください。search_api または call_api を利用できない場合は、この会社で採用を行うには、オペレーターが Runner API ツールを有効にする必要があると報告してください。提案する採用内容は会話に残してください。エージェントを作成したと主張したり、依頼された恒久的な採用の代わりに一時的なサブエージェントを使用したりしないでください。

1. 本人確認と会社のコンテキストを確認する

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

2. この Paperclip インスタンスのアダプター構成を確認する

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:
curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

3. 既存のエージェント構成を比較する

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

会社がすでに採用している命名、アイコン、報告系統、アダプターの規約を確認します。

4. 役割を説明する

新しいエージェントのために、そのエージェントのアイデンティティと担当する責任を簡潔な段落で説明します。役割の例 は任意の出発点です。それ以外の役割については、基本的な役割ガイド を使用してください。

依頼者から提示された会社固有の指示を優先してください。役割の説明を一般的な運用マニュアルに広げないでください。ハーネスが Paperclip の調整、スキルの検出、タスクのライフサイクルに関するガイダンスを提供し、適用される作業手順はリポジトリの指示とインストール済みスキルが担います。採用するエージェントの指示に、ハートビートへの参照、実行契約、操作ごとの必須コメント、固定されたレビュー担当者の指定、ドメイン概念の一覧を追加しないでください。

報告系統は reportsTo に、能力は capabilities に、スキルは desiredSkills に記載してください。これらのフィールド、タスク、リポジトリの指示、インストール済みスキルですでに表現されていない、具体的な会社または役割の要件に限って、指示の詳細を追加してください。

5. 使用可能なエージェントのアイコンを確認する

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

6. 新規採用の設定を下書きする

• 役割／肩書き／名前
• アイコン（実際には必須です。/llms/agent-icons.txt から選択してください）
• 報告先（reportsTo）
• アダプターの種類
• 初日からインストール済みのスキルが必要な役割の場合は、社内スキルライブラリから desiredSkills を指定します
• desiredSkills またはアダプター設定によって、ブラウザーアクセス、外部システムへのアクセス範囲、ファイルシステムの対象範囲、またはシークレットの取り扱い能力が拡大する場合は、それぞれの理由を採用コメントで説明します
• この環境に合わせたアダプターとランタイム設定
• タイマーによるハートビートはデフォルトで無効にします。役割上、定期的なスケジュール実行が本当に必要な場合、またはユーザーが明示的に依頼した場合に限り、runtimeConfig.heartbeat.enabled=true と intervalSec を設定します
• 役割上、非公開の勧告や機密性の高い情報開示を扱う可能性がある場合は、まず機密情報を扱うワークフロー（専用のスキル、または文書化された手動プロセス）が存在することを確認します
• 機能
• ステップ 4 の役割指示を渡す場合、マネージドバンドルアダプターでは、トップレベルの instructionsBundle.files["AGENTS.md"] として渡します。それ以外の場合は、サーバーのデフォルトを使用します。新しいエージェントでは adapterConfig.promptTemplate や bootstrapPromptTemplate を設定しないでください。
• この採用が課題に起因する場合は、元の課題との関連付け（sourceIssueId または sourceIssueIds）

7. 品質チェックリストに照らして下書きを確認する

送信前に、下書きレビューのチェックリストを最初から最後まで確認し、合格しない項目があれば修正します。 skills/paperclip-create-agent/references/draft-review-checklist.md

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>"
  }'

9. ガバナンスの状態に対応する

• レスポンスに 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 コメントを投稿します。

参考資料

• 役割の任意の例：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

ハーネスとランナーの選択

adapterType で、codex_local や claude_local などの基盤ハーネスを選択します。新しい Codex エージェントでは、対応する 実行ターゲット上で Paperclip Runner が自動的に使用されます。新しい Claude Code エージェントでは、Apple Silicon、 Intel Mac、Linux x64、対応する glibc を備えた Linux ARM64 で Paperclip Runner が使用されます。認識できない、または未対応の ターゲットでは Legacy が維持されます。Darwin SSH もデフォルトでは Legacy です。ネイティブ実行には、ランナーの明示的な選択と、 一致するリモートアセットが必要です。ネイティブ Claude プロファイルは provider: acpx、acpxAgent: claude で、通常のモデルは claude-opus-5-5 です。 明示的に指定したモデルと既存の保存済みランナーはそのまま維持されます。そのため、保存された応答には adapterType: paperclip_runner と解決済みのプロバイダーが含まれる場合があります。以降の読み取りや編集には、 返された設定を使用してください。

任意の作成フィールド runner には、auto、paperclip、legacy を指定できます。 ネイティブランタイムでは対応できない CLI 設定が必要な場合は、legacy を使用してください。 Claude では、Chrome、カスタムコマンド／状態パス、ウォームプロセス制御、実行制限、ターン数の上限が該当します。 ネイティブ Claude は既存の API キーおよびサブスクリプション接続を使用します。設定したエフォートには、プロバイダーによる確認が必要です。セットアップや認証のエラーによって、ランナーが暗黙に変更されることはありません。 既存のエージェントは、無関係な編集を行っても保存済みの実行設定を維持します。承認された採用では、ボードがレビューした設定が使用されます。 inheritRuntimeFrom: caller は、既存のランタイム継承と認証情報の制限を維持します。

CLI 相当のコマンド：paperclipai agent create --runner legacy --payload-json ... および paperclipai agent hire --runner legacy --payload-json ...。