mashimashica エージェント作業システムの設計
目的
対象の仕事と適用条件に適した、エージェント・ツール・情報資源・実行環境の構成と相互作用を設計し、その実現可能性と有効性を確かめる。
成果
- 構成の責務と相互作用が、適用条件の下で対象の仕事を網羅している。
- 判断と処理の配分が、仕事と利用可能な能力によって正当化されている。
- インターフェースと情報供給が、必要な相互作用と結果の解釈に十分である。
- 依頼範囲内の実現が、適用可能な証拠に裏付けられ、定められた動作を満たしている。
- 実現可能性と有効性の判断が、検討した仕事に裏付けられ、仮定、未確認事項、限界が明示されている。
活動とタスク
以下のタスクは、推奨と明示したものを除き、依頼範囲内で必須とする。それらの関係は、証拠の変化に応じた設計の再検討を可能にする。
設計の基礎の確認
- 対象の仕事の参照元となる記述、適用条件、利用可能な能力、依頼された設計・実装・評価の範囲を識別する。影響を受ける関係者からの必要な情報を確認し、依存する判断を制限する不足を識別する。
- 仕事の記述が、依頼された設計に十分であるかを判断する。その意味と成功条件は二重に保持せず、参照する。構成が支える記述とSkillを識別する。それぞれを異なる構成で支えてもよい。構成の不足や証拠の欠落を、仕事の前提の問題と区別する。指摘によって正当化される場合は、手段を調整するか、影響する記述を再検討する。変更が依頼範囲に含まれ、フレームワークの変更原則に従って正当化される場合を除き、その意味を維持する。
責務と相互作用の構成
必要な能力に照らして、既存のエージェント・ツール・資源・環境を評価する。必要な文脈依存の解釈・選択・構成をエージェントへ、確定した処理と判断規則を適切な実装へ配分する。
構成要素の責務とインターフェース、情報の出所と条件、結果と失敗への対応を定める。内部モジュールの境界と、エージェントへ公開する操作を区別する。有用な場合は安定した操作をまとめ、意味のある選択を維持する。
エージェント・ツール・環境を、実行支援要素として仕事へ対応付け、フレームワークに従って各情報資源の役割を識別する。ツール操作がタスクへどう寄与し、その結果が成果の評価をどう支えるかを説明する。タスクの境界とツールのインターフェースは、それぞれの責務に応じて設計する。遂行や評価に必要な場合は、プロセスの入力・出力を、引数や返される情報へ対応付ける。
ツールに実装する規則や制限を、適用される統制事項と制約へ対応付け、共通の参照元、範囲、各操作がそれらをどう適用するかを識別する。選択したツールや環境による限界を仕事の要求と区別し、実現可能性や成果の判断への影響を評価する。
方法・ツール・接続の新設や調整が必要な不足を識別する。境界は、凝集性、変更影響、利用・組合せ・検証のしやすさで判断する。簡素化する際は、構成要素の削除や統合によって、どの責務、意味のある選択、証拠が失われるかを検討する。
依頼された構成の実現
- 依頼範囲内で、適用される環境を用いて必要な能力を実装・接続する。既存のCLIやAPIを直接利用してよい。ツールの利用方法、依存関係、結果の解釈、失敗への対応、状態を変更する影響を、必要な箇所で確認できるようにする。
- 対象がSkillである場合、仕事、判断基準、必要なツール利用、条件を
SKILL.mdと必要な資源へ反映する。Markdownにはフレームワークの記述規則を、Agent Skillとの対応付けにはプロセス記述の設計に関する指示を適用する。同梱する業務処理は対象Skillのscripts/へ置き、スクリプト作成ガイドに従って説明する。設計Skillのスクリプトは、その設計や評価の仕事を支援しなければならない。 - 必要な資源とその利用条件を、意図した配布構成の下で確認できることを検証する。パッケージ内のリンクはその構成の下で解決しなければならない。外部参照は、意図した参照元を識別し、アクセス条件がある場合はそれも識別しなければならない。
- 依存する操作の前に、必要条件を確認する。状態を変更する操作を再試行する前に、不確かな影響や一部だけ生じた影響へ対応する。
システムの評価と調整
対象の仕事に照らして、設計の責務、関係、条件をレビューする。関係する失敗や不完全な結果を含め、構成要素と接続を定められた動作に照らして検証する。
許可され、利用可能な範囲で、意図したエージェント・ツール・情報・環境を用いた代表的な仕事を評価する。証拠と適用条件に照らして仕事の成果を評価し、ツールの完了や生成された出力と区別する。
証拠や能力変化が根拠となる場合、指示、情報供給、公開操作、配分を再検討する。能力の限界を補う誘導を見直す際も、仕事固有の知識と条件を維持する。変更された依存関係のうち、どれが既存の証拠と判断に影響するかを識別する。根拠が引き続き適用できる証拠を保持し、影響する動作を再検証する。
各判断の対象、基準、証拠、範囲、未実施の検証、未解決の指摘を報告する。レビューでは、提供された設計について本Skillの成果を評価する。欠陥を識別しても、未達成のままの条件が満たされたことにはならない。
統制事項
このプロセス記述にはプロセスフレームワークを、設計対象にはエージェント作業システムの設計原則を適用する。対象がAgent Skillの場合、物理的な形式にはAgent Skills仕様を、同梱する処理の説明にはスクリプト作成ガイドを適用する。これらは、それぞれの対象について必須参照である。設計範囲は、対象の仕事の記述、ユーザーの依頼、利用環境の適用条件が定める。
制約
レビューだけの依頼には、指摘と依頼された修正を返し、求められていない変更を行ってはならない。対象業務の実行は別の適用であり、適用される権限の範囲内に収めなければならない。参照不足や未確認の条件は、依存する行為と判断を制限しなければならない。独立した分析や草案作成は、それぞれの条件の範囲内で続けてよい。実施していない評価は、未確認のまま明示しなければならない。
資源
本ファイルは、ルートのSKILL.mdをもとに、その意味と規範強度を維持する日本語訳である。