pstack-harness

ハーネスアダプター

途中で切れた読み取りは、読み取っていないのと同じです。 戻り値が短縮されている場合、途中で切れたという警告がある場合、または head、tail、行数制限で出力を制限した場合は、そのファイルや差分を最後まで読めていません。実行に移る前に、残りの部分を読んでください。このファイルも同様です。Codex では、ファイルの読み取りに従ってください。

pstack ワークフローで委任アクション、作業リスト、質問、ループ、トランスクリプト、ポータブルリソース、シェルコマンド、またはプロセスの調査が指定されている場合に、このスキルを使用してください。

ツール一覧と CLI のヘルプが正しい情報源です。ツールを決してでっち上げないでください。実行や証拠に影響する場合は、その仕組みを報告してください。作業リストについては、運搬手段ではなく項目の状態を報告してください。

シェルコマンドを実行する前、または実行中のものについて回答する前に、シェルコマンドと実行中のプロセスを読んでください。これはすべてのアクションとランタイムに適用されます。

アクションを選択する

選択した各リファレンスは、そのアクションを実行する前に最後まで読んでください。次のステップで必要なアクションだけを選択してください。リファレンス内のリンクは、説明されている操作が該当する場合にのみ読んでください。すべてのリファレンスを読む必要はありません。

アクション	必須のリファレンス
worklist	作業リストの手順
question	構造化された質問
spawn	以下のロールを起動する手順、委任と分離、および現在のランタイムアダプター。ハンドオフ、復旧、trail reviewer、または解決ツールが失敗するか注記を出力する場合にのみ、ロールの解決とハンドオフを読みます。PSTACK_SKILLS_ROOT が未設定の場合にのみ、ポータブルリソースのパス契約を読みます
role-handoff	ロールの解決とハンドオフ
persona	起動時にペルソナを指定する場合は、ペルソナ契約
loop	ループと再開
transcript	ワークスペースのトランスクリプトおよび現在のランタイムアダプター
portable-paths	コマンドで PSTACK_SKILLS_ROOT、PSTACK_SOURCE_ROOT、または PROJECT_ROOT を使用する場合は、ポータブルリソースのパス契約

ランタイムアダプター

コンテキストの圧縮、スキル内容の短縮、またはスキルの復元が次のアクションに影響する場合は、スキル保持の証拠を読んでください。文書化された制限、ランタイムでの観察結果、未知の動作は、それぞれ分けて扱ってください。

起動またはトランスクリプトの場合は、そのアクションに対応する現在のランタイム列だけを読んでください。それ以外のアクションではランタイムアダプターは不要です。

ランタイム	起動アダプター	トランスクリプトの場所
claude-code	Claude Code	トランスクリプトの場所
codex	Codex	トランスクリプトの場所
hermes	Hermes	トランスクリプトの場所
grok	Grok Build	トランスクリプトの場所
other	その他のランタイム	トランスクリプトの場所

ポータブルリソースを解決する

次のコマンドで必要となるルートだけを解決してください。生成されるプランではコマンドの形式を正確に保ち、所有者、委任先、再開時、および後続のティックにわたって、記録されたルートを復元してください。

ハンドオフ間でロールを維持する

ロールのハンドオフまたは復旧の前に、上で選択したロールの解決とハンドオフに関するリファレンスを読んでください。

ロールを起動する

すべての pstack の起動では、feature や how explorer など、モデル設定にあるロールが実行されます。ペルソナを伴う場合もあります。呼び出し元のロールとパネルのアーム数を維持してください。

1. スキルまたはプレイブックのステップからロールを取得します。ロールの指定がないステップでは、default を使います。subagent_type が poteto-agent または comment-sicko の場合はペルソナを指定し、general-purpose の場合はペルソナを指定しません。

2. タスクごとに一度解決し、ハーネスまたは設定が変更された後にも再度解決します。プロジェクトのルートからリゾルバーを実行するか、--project <root> を渡してください。リゾルバーはそのディレクトリの .agents/pstack-models.md を読み込みます。値を選ぶために設定ファイルを読んではいけません。

   python3 "${PSTACK_SKILLS_ROOT:?}/setup-pstack/scripts/check-models-config.py" --resolve --harness <claude-code|codex|grok|hermes> <role>
   

   失敗の兆候：終了コードが 0 以外です。各アームについて model、effort、source を含む JSON を 1 行ずつ出力し、返信で伝える notes も出力します。失敗した場合、メモが出力された場合、またはロールが trail reviewer の場合は、roles.md の ロールを起動する に従ってください。リゾルバーが失敗しても、起動を取りやめてはいけません。モデルとエフォートを省略して起動し、その旨を報告してください。

3. 現在のランタイムアダプターから呼び出しを組み立てます。フィールドの値が inherit-parent の場合は、そのフィールドを省略します。

4. ペルソナを指定する場合、そのペルソナのネイティブ名がライブエージェントカタログにない限り、python3 "${PSTACK_SKILLS_ROOT:?}/pstack-harness/scripts/subagents.py" brief <persona> で取得した完全なブリーフィングをプロンプトの先頭に置きます。

5. 各アームが使用したモデルとエフォートを報告し、レビューで使用したモデルが作業時のモデルと一致する場合は、same-model とラベル付けします。

共通ルール

• 名前が指定された兄弟スキルは、自分で使用してください。 「architect を指定して Skill ツールを呼び出す」とは、pstack スキル architect を読み込み、その手順に従うことを意味します。その後に「そのスキルの」または「そのスキルを使って」と続く場合、スキル全体を読み込んだうえで、そのステップに必要な部分が指定されています。スキル名は、このスキル自体のディレクトリを含むインストール済みスキルのルートにある兄弟ディレクトリです。その他の pstack の記述でスキル名が挙げられている場合（「リーフスキル」や「arena スキル」など）も、同様にそのスキルを指します。Claude Code では、architect のように名前だけを指定して Skill ツールを呼び出します。説明なしで名前だけが表示されていても呼び出せます。また、名前だけの表示はスキルが見つからないことを意味しません。Codex、Grok Build、Hermes、およびその他のハーネスには、これらのスキル用の Skill ツールはありません。その場合、同じ表現は <installed skills root>/<name>/SKILL.md を全体にわたって読み、手順で必要になったら参照先のファイルも読むことを意味します。Codex では、ユーザープロンプト内の $name という記述によって、そのスキルの SKILL.md が注入されます。そのため、注入された内容が途中で切れていない限り、同ファイルを再度読んではいけません。pstack スキルが指定したスキル名をユーザーに入力するよう求めてはいけません。スキルの読み込み方法を変更するために、スキルのファイルやリストの設定を編集してはいけません。
• 指定されたスキルだけを読み込んでください。 ユーザーまたは読み込み済みのスキルが指定していない限り、スキルディレクトリの一覧表示や検索で見つけた pstack スキルを読んだり読み込んだりしてはいけません。ハーネスに説明が表示されるスキルは、その説明から読み込んでもかまいません。
• スキルのテキストにあるツール名は意図を示すものであり、必須のツールを指定するものではありません。 Task、Glob、Grep、Read、作業リスト、readonly のような Cursor 時代のパラメーターは、実行可能な機能を表します。検索ツール、シェルコマンド、読み取り専用の概要など、セッションで利用できる手段を使って、それぞれの機能を実現してください。利用可能な機能は、記憶しているツール名ではなく、現在の説明に基づいて選択します。省略可能なツールが見つからなくても、そのステップを取りやめたり、知らせたりする必要はありません。スキルテキスト内の subagent_type は、ペルソナを指定するか、指定しないことを示します。ロールを起動する に従って、具体的なタイプを決めてください。