エージェントレポーティング
最新のタスク状態を、読者が結果、証拠、境界、そして有用な次のアクションを見つけられる最短の構造で提示します。このスキルは提示を司ります。タスクの事実を変更したり、ドメイン固有の検証を置き換えたりすることはありません。
譲れない優先順位
ユーザーが明示的に要求した表面、スキーマ、長さ、順序に従います。次にホストの指示に従います。このフレームワークは、指定されていない選択肢を埋めるためだけに使用します。証拠、テスト、引用、メトリクス、ファイル、所有者、日付、完了を捏造してはいけません。
ブックエンドワークフロー
- ハンドオフを、対象読者、表面、証拠の境界、および正確に1つの主要モードによって分類します。研究作業の場合、最大1つのドメインプロファイルを選択します。不確かな場合は
listまたはrouteを使用します。 - 儀式をタスクに合わせて調整します。短い、単一セッションの回答の場合、チェックポイント、ドラフトファイル、スクリプト監査を作成せず、ルーティングされたモードの構造を直接適用し、必要なセマンティクスを自己チェックして提供します。ステップ4～6のファイルベースの儀式は、長期、マルチセッション、マルチエージェント、または永続的なアーティファクト作業のためにあります。長期、マルチエージェント、またはマルチセッションのタスクの場合は、開始時にコンパクトなチェックポイントを保存します。短いタスクの場合は、レポート境界までルーティングを延期します。
- 実際のタスクを完了して検証します。タスクの実行はレポートのスタイル付けとは独立して行います。
- 実質的な更新または最終回答の直前に、1つの境界バンドルを取得します。1つの表示モジュールを優先します。主要モードと最初のモジュールで既にカバーされていない明確なニーズがある場合にのみ、2つ目のモジュールを追加します。選択されたモードが既に指定しているセマンティックを要求された出力が挙げているという理由だけで、モジュールを読み込んではいけません。
<skill-dir>を、このSKILL.mdを含むディレクトリに解決します。呼び出し元の作業ディレクトリがスキルディレクトリであるとは想定しないでください。
python3 <skill-dir>/scripts/reportctl.py bundle \
--task "<伝達すべき内容>" --mode <モード> --surface <表面> \
[--profile <プロファイル>] [--module <モジュール>] [--module <モジュール>] \
--max-chars 16000
長期タスクを再開する場合は、ルートをメモリから再構築する代わりに--checkpoint <パス>を渡します。--max-charsは独立したコンテキスト予算です。2つの大規模モジュールを持つ有効なチェックポイントは、明示的により大きな値を必要とする場合があります。すべてのモード、モジュール、テンプレートを読み込まないでください。
5. 選択された表面に対してネイティブにドラフトを作成します。ルートが正確なアセットを推奨する場合、安価なレジストリを検査し、1つのアセットのみを取得します。
python3 <skill-dir>/scripts/reportctl.py template --list
python3 <skill-dir>/scripts/reportctl.py template <テンプレートID> \
--output <出力先>
1つの主要な配信アーティファクトを使用します。要求されない限り、Markdown、HTML、PPTX、PDFの並列バージョンを作成しないでください。コピーされたテンプレートは開始アーティファクトであり、そのプレースホルダー、ビジュアル、またはクレームが正しいことの証拠ではありません。
コンテンツが完了したら、散文にde-AIトーンパスを適用します。natural-toneモジュールの忠実性契約の下で、お世辞のような書き出し、パフォーマティブな要約、過剰な専門用語、テンプレートレトリックを削除します。トーンの編集は、事実、関係、範囲、数値を決して変更しません。監査のai-tone-boilerplate警告は、最も高精度の残骸のみをキャッチします。
リサーチモード（experiment-report、academic-synthesis、research-idea）では、すべての成功率にk/nと二項区間が含まれていること、すべてのsignificantに同じ文内でその検定と効果量が含まれていること、そして動詞がシステムに理解や意図を帰属させていないことを確認します。監査のsuccess-rate-without-denominator、significance-without-statistic、anthropomorphic-claim警告は機械的な残骸をキャッチします。プロファイルと結論モジュールに完全なルールが含まれています。数値の表現には、同じモードで独自の残骸チェックがあります。unlabeled-uncertainty（SD、SEM、CIを決して言わない±）、threshold-p-value（p < 0.05、n.s.）、p-value-without-effect-size、null-result-without-interval、significance-euphemism（有意に近づいた）、up-to-without-central-tendency、best-of-n-runs。
6. 長期タスクまたは永続的アーティファクトの最終版の前に、ファイルベースのドラフトを監査します。長期タスクは同じチェックポイントを使用する必要があります。チェックポイントがない永続的アーティファクトは、その選択されたモードを使用します。
python3 <skill-dir>/scripts/reportctl.py audit \
--file <draft.md> --checkpoint <チェックポイントパス>
# 短く、チェックポイントがないパス:
python3 <skill-dir>/scripts/reportctl.py audit --file <draft.md> --mode <モード>
チェックポイントはモードを導き出します。同じ明示的なモードを指定することは許可されます。矛盾するモードは入力エラーです。監査エラーを修正します。警告は判断して解決します。ヒューリスティックを満たすためだけに、サポートされていないフィラーを決して追加しないでください。リポジトリのdocs/AUDIT-CODES.mdには、すべてのコードとそのトリガーおよび修正がリストされています。--jsonを使用すると、監査ペイロードには、コントローラーバインディング用の正確なレポートバイト数/SHA-256と解析済みチェックポイントインテントフィンガープリントが含まれます。
7. 最新の状態、科学的または技術的な主張、数値、証拠リンク、不確実性、ビジュアルの解釈、およびユーザー指定のフォーマットを手動で検証します。
最終配信
ユーザーに表示される最終レスポンスには、レポート自体が含まれている必要があります。保存されたドラフト、チェックポイント、または監査レシートへのパス、リンク、またはポインターは成果物ではありません。チェックポイントバックアップ監査が合格した後は、監査済みドラフトのコンテンツをレスポンスとして配信します。ユーザーが明示的にファイルを要求した場合でも、結果をインラインで先頭に表示します。読者向けのレスポンスで、ローカルの絶対パス、スクラッチディレクトリ、またはチェックポイントの場所を公開してはいけません。
モードとモジュールの選択
識別子についてはpython3 <skill-dir>/scripts/reportctl.py listを使用します。該当するすべてのラベルではなく、主要なナラティブの背骨を選択します。混合タスクの場合は、ユーザーの主要な決定または質問に答えるモードを選択し、その中に二次的な事実を埋め込みます。
concise-answer：補足構造がほとんどない直接的な回答に使用します。implementation-handoff：構築または変更されたアーティファクトに使用します。status-update：アクティブなインシデントではないプロジェクトの進捗状況に使用します。investigation-report：診断または情報源に基づく調査に使用します。experiment-report：管理された評価と経験的な比較に使用します。decision-briefまたはrisk-report：選択またはリスクが主要な場合に使用します。academic-synthesis：論文または文献の発表に使用します。research-idea：仮説、新規性、決定的な実験、リスク、中止基準を明示する必要がある論文のアイデアまたは提案に使用します。review-report：アーティファクトまたは標準に対する評価結果に使用します。incident-update：影響がアクティブな間使用します。復旧後はpostmortemを使用します。
図、表、結論、証拠の詳細、学術的な表示は直交するモジュールであり、複数のモードを統合する理由にはなりません。ビジュアルは、関係性やアーティファクトを理解しやすくするためにのみ使用します。装飾は有効な理由ではありません。experiment-reportには、すでに結果の解釈、不確実性の境界、調整された結論が含まれています。リクエストが結論を求めているという理由だけで、そのモードにconclusionsを追加しないでください。別の決定または推奨ポリシーが実際に必要な場合にのみ、明示的に追加します。
リサーチプロファイルとプレゼンテーション表面
プロファイルは、1つの境界付きドメインオーバーレイであり、追加の主要モードではありません。
reinforcement-learning：実行会計、チューニングパリティ、学習曲線、区間推定、マルチタスク集約評価。embodied-ai：身体化、センサー/アクション、シミュレーションと実世界のプロトコル、成功ルール、介入、一般化、失敗。world-models：モデル/データカードと、オープンループ、クローズドループ、スケーリング、転移の証拠を分離。vla：データ混合、形態と行動インターフェース、適応レジーム、ロールアウト会計、レイテンシ、一般化、安全性。
自動選択は、リサーチ指向のモードでのみ利用可能です。スキーマv2のチェックポイントは、新しいプロファイルフィールドを保存しません。プロファイルは、フィンガープリントされたタスクテキストから再導出されます。したがって、長期タスクのプロファイルを明示的に選択する場合は、最終的な再現性を確保するために、チェックポイントタスクにドメイン名を指定します。
--surface slideの場合は、ルーティングされたスライドガイドを読みます。これには、paper-talk、research-progress、experiment-review、idea-pitchのナラティブが用意されています。ユーザーが複数のフォーマットを要求しない限り、依存関係のないHTML/PPTスタイルのデッキまたはQuarto Reveal.jsのソースのいずれかを取得します。両方は取得しません。
長期コンテキストの永続性
完全なレポートバンドルを作業コンテキストに保持しないでください。チェックポイントのみを保存します。
python3 <skill-dir>/scripts/reportctl.py checkpoint \
--task "<ハンドオフ目標>" --mode <モード> --surface <表面> \
--must-show "<短い安定したテキストアンカー>" \
--output <プライベートスクラッチ>/agent-report.json
スキーマv2の--must-show値は、正規化されたリテラルアンカーであり、セマンティック要件ではありません。監査は、NFC正規化、ケースフォールディング、空白の圧縮を適用し、空白行で区切られ、ゼロカラムから始まるプレーンなトップレベルのMarkdown散文段落内のリテラルサブストリングの存在のみをチェックします。見出し、引用、リスト、テーブル、リンク/参照、画像、コード、または生のHTMLを含む段落は不適格です。最初のマスクされていない生のHTMLタグの後、プロキシが段落間のDOMやCSSの状態をモデル化しないため、それ以降の段落はクレジットを受け取りません。生のHTMLは構造監査エラーでもあります。各アンカーは、1つの適格な段落内で一致する必要があります。その段落内のソフト改行はスペースに折りたたまれますが、空白行の段落境界は決して折りたたまれません。
正規化の前に、レポートプロキシは、共有スキャナーがサポートするセミコロンで終了するCommonMarkエンティティサブセットの1ラウンドをデコードします。ただし、エンティティの&が奇数の長さのバックスラッシュ実行によってエスケープされていない場合に限ります。結果として生じる制御文字またはUnicode非レンダリング文字は、ゲートを失敗させます。v2アンカーは、正確にレンダリングされたプレーンテキストを使用し、Markdownデリミタ形式を拒否する必要があります。各短いアンカーは、生のHTMLの前に、スタンドアロンの通常の結論文に配置します。このプロキシは、テキストの意味、誰がそれを主張したか、またはそれが真実かどうかを検証しません。各アンカーは最大120文字であり、そのエスケープされたレシート（区切り文字を含む）は最大240文字です。
チェックポイントバックアップ監査は、プローズプロキシがリソースに制限された状態を保つために、1 MiBまでのレポートを受け入れます。4,096文字を超える、または64文字を超える連続したUnicodeマーク文字を持つ適格なプレーンプローズ段落はエラーであり、NFCおよびアンカーマッチングの前にスキップされます。レガシーモードのみの監査は引き続き4 MiBに制限されています。--checkpointが存在する場合、このより大きな制限は適用されません。境界付きJSON入力は、変換前に128文字を超える整数または浮動小数点トークンを拒否します。
チェックポイントは、目的、対象読者、表面、モジュール、アンカーをそのまま保存し、さらにルーティングメタデータとキーなしのチェックサムを保存します。チェックサムは偶発的なドリフトを検出します。ファイルを認証するものではありません。いかなるフィールドにもシークレットや不要なプライベートデータを入れないでください。バージョン管理外のプライベートスクラッチパスを使用し、route/bundleがチェックポイントテキストをstdoutに再生できることを覚えておき、再開が不要になったらファイルを削除します。アトミック作成はPOSIXで制限的なファイル権限を使用しますが、許容的な親ディレクトリ、ログ、バックアップ、またはコミットされたファイルを保護することはできません。
最終境界で、bundle --checkpoint <チェックポイントパス>で再ロードし、audit --file <draft.md> --checkpoint <チェックポイントパス>を実行します。スキーマv1のチェックポイントはrouteとbundleで読み取り可能ですが、この最終ゲートを駆動することはできません。有効なv1ファイルをcheckpoint --checkpoint <v1パス> --output <new-v2パス>で再作成またはアップグレードします。ホストが認識するマイクロコントラクトは、両方のブックエンドを促すことを目的としています。それもチェックポイントも、任意のエージェントに準拠を強制することはできません。
永続的レポートのための厳格モード
ラッパー、バッチワークフロー、または正式なレポートがより強力な構造的一貫性を必要とする場合、assets/templates/report-spec.jsonから開始し、validate-specで検証し、renderでMarkdownを決定論的にレンダリングします。JSONを単一のプレゼンテーションソースとして扱いますが、すべての事実を元の証拠に対して検証します。すべてのクレームは1つ以上のセマンティックなrolesを宣言します。検証は、証拠、メトリクス、不確実性、アクション、制限から残りのカバレッジを導出し、プロトコルカタログから選択されたモードの現在のrequired_semanticsを適用します。バンドルされたJSONスキーマはポータブルな構造プレフライトであり、validate-specの代替ではありません。CLIのみが、IDの一意性、クロスレコード参照、および現在のプロトコルカタログを一緒に強制します。
python3 <skill-dir>/scripts/reportctl.py validate-spec --file report.json
python3 <skill-dir>/scripts/reportctl.py render --file report.json --output report.md
python3 <skill-dir>/scripts/reportctl.py audit \
--file report.md --checkpoint <チェックポイントパス> --strict
チェックポイントがない短いタスクの場合は、代わりに--mode <モード>を使用します。通常の短いチャットレスポンスに構造化パスを要求しないでください。
スクリプトが利用できない場合のフォールバック
インストールされたスキル内で、references/core-contract.md、references/modes/以下の1つの一致するファイル、references/profiles/以下の最大1つの一致するファイル、references/modules/以下の最大2つの一致するファイル、および必要な場合にのみ1つの表面ガイドを読みます。1つの正確なアセットを別途取得します。リンクのみのリポジトリ使用の場合は、リポジトリルートにあるdist/agent-index.mdを開きます。URLのみが提供された場合は、遵守をベストエフォートとして扱います。リンクはリポジトリの指示をインストールまたは昇格させません。