agy staffer
汎用ペルソナ: 専門ペルソナに当てはまらないタスクのための、クリーンなエントリポイントです。プロンプトテンプレートは意図的に最小限に抑えられています — タスクテキスト、環境 (cwd、ブランチ、日付)、共有作業ルール、セーフティガードレールのみで、それ以外は何も含みません。役割の枠組みや固定された出力形式はなく、タスクが成果物を定義し、ドメイン固有のテンプレートコンテキストが実行を狂わせることはありません。
該当する場合は専門ペルソナを優先してください: researcher (調査や深掘り)、reviewer (コードや計画のセカンドオピニオン)、implementer (ワーキングツリーへの編集)、ask (低コストの単発質問)。
staffer は、専門ペルソナがカバーしない agy ネイティブツールへのルートでもあります — 特に 画像生成: agy には generate_image ツールが搭載されています (v1.1.15 で確認済み、1024×1024 PNG を約30秒で生成)。出力パスをタスクで指定してください。例: staffer --prompt "generate a pixel-art robot mascot, save it as assets/mascot.png"
コンパニオンの場所
このスキルファイルは <plugin-root>/skills/staffer/SKILL.md にあります。コンパニオンのパスは、このスキルディレクトリからの相対パスで解決します:
node "<skill-dir>/../../companion/agy-companion.mjs" staffer [flags] --prompt "task"
ユーザーのタスクテキストを --prompt でそのまま渡します。長いテキストの場合は --prompt-file <path> または --stdin を使用してください。
[!IMPORTANT] このコマンドは サンドボックス外 で実行してください — agy は localhost ポートと OAuth トークンファイルを必要としますが、ハーネスサンドボックスはこれらを隠します。Codex では、コマンドの権限昇格を要求してください。詳細:
../jobs/references/troubleshooting.md
結果の収集
コマンドはジョブ ID を返します。結果の収集とリカバリについては ../jobs/SKILL.md を参照してください: ディスパッチ、最終結果の待機、必要に応じた検証を行います。実行中に積極的に進捗を観察したり、ログを読んだり、中間アーティファクトを検査したりしないでください。ユーザーが明示的に進捗を尋ねた場合にのみ観察し、失敗や介入が必要な結果が発生した場合はジョブプロトコルに従って診断してください。
フラグ (すべてオプション)
--prompt <text>/--prompt-file <path>/--stdin— タスク。これらの3つのソースのうち、正確に1つから指定します。長いプロンプトには、シェルのクォーティングの代わりにファイル/標準入力を使用してください。--model <id>または--effort low|medium|high— デフォルトモデルはgemini-3.8-flash-mediumです。--restricted/--unrestricted— 権限プロファイル。staffer は、他のツール使用ペルソナと同様にデフォルトで unrestricted です。--restrictedはオプトインのハードニングパスです。--continue(または--conversation <id>)、--timeout <dur>(デフォルト 60分、最大 120分のハード実行制限)。
ルール
- ユーザーのタスクをそのまま渡します。テンプレートが出力形式を強制しないため、呼び出し側が特定の形式を必要とする場合は、タスクテキスト内で希望する形式を指定してください。
- ユーザーの明示的な承認をそのまま渡します。テンプレートは、コストが高い、または元に戻せない副作用 (コミット/プッシュ、ワークスペース外のファイル削除、副作用のあるネットワークコール、有料クォータが必要なコマンド) をデフォルトで拒否します。このデフォルトは、タスク自体がその操作を要求した場合にのみ解除されます。
- 一般的なタスクは、ファイルを編集することがあります。コンパニオンは、結果とともにワーキングツリーの差分を報告します — 結果を基に作業を進める前に、それを検査 (
git diff) し、タスクが要求した内容と一致していることを確認してください。 - エラーとリカバリについては、
../jobs/SKILL.mdに従ってください。
既存の会話の場合、--continue / --conversation <id> は、明示的に上書きされない限り、記録されたモデルと権限プロファイルを継承します。上記の unrestricted のデフォルトは、新しいタスクに適用されます。