mashimashica プロセス記述の設計
目的
対象作業の目的と成功条件を、必要十分な境界と詳細を持つ、理解・適用・評価可能なプロセス記述として明確にする。
成果
- 対象作業が、目的、適用範囲、隣接作業との境界によって識別されている。
- 成功条件が、それぞれ目的の達成に必要で、全体として目的を満たすために十分な、観察可能な結果状態として記述されている。
- 作業の理解・適用・評価に必要な詳細が記述に含まれている。
- 適用条件によって必要となる場合を除き、実行手段の選択が開かれている。
- フレームワークおよび必要な参照との、記述の整合性が明らかになっている。
- 未確認事項と適用上の限界が明示されている。
活動とタスク
以下のタスクは、推奨と明示したものを除き、依頼された範囲内で必須とする。それらの関係は、理解の進展に応じて記述を再検討することを支える。
対象作業の明確化
- 依頼範囲と、利用可能な記述または対象作業の情報を識別する。
- 影響を受ける関係者からの必要な情報を用いて、作業が成立させることを引き受けた結果と、隣接作業との境界を明確にする。その責任を、便益や他の作業が担う結果と区別する。情報の出所と適用可能性を確認し、不足を識別する。
- 意図した範囲や成功条件を変え得る不確実性を識別する。
成功条件と作業の記述
- それぞれ目的の達成に必要で、全体として目的を満たすために十分な、観察可能な成果を記述する。独立して評価できる結果を区別可能に保つ。
- 省くと理解・適用・評価が損なわれる詳細を含め、いずれにも寄与しない重複は削除または統合する。作業詳細が必要な場合は、関連する行為を有用な粒度の活動とタスクへ整理し、成果への寄与を確認する。
- 必要な入力、出力、統制事項、制約、実行支援要素、開始基準、完了基準を、その機能に基づいて記述する。必須の方法と依存関係は適用範囲とともに維持し、それ以外の実行上の選択を開いておく。
- Markdownではフレームワークの記述規則を適用する。対象がAgent Skillの場合は、本文にプロセス記述を、frontmatterに発見用の識別子と、作業およびその適用場面の要約を記述する。frontmatterとHost表示を、記述の意味と範囲に整合させる。
参照元と関係の整合
- 参照元となる記述を識別し、必要な参照を意図した出典に照らして確認する。必要な資源の役割と利用条件を明確にし、参照資料と作業の記述を区別する。Skillでは、意図した配布構成の下でパッケージ内のリンクが解決し、外部参照が参照元を識別し、アクセス条件がある場合はそれも識別していることを確認する。
- 関連する作業と共有する情報の意味、利用、変更影響を、どの作業が参照・更新するかを含めて明確にする。
- 変更では、対象となる記述と要素、範囲、根拠、影響、必要な再検証を明確にする。参照元となる記述の変更、文脈限定の変更、一回の適用に固有の選択、見せ方の変更を区別する。
- プロセスを選択する場合やその意味を変更する場合は、判断の裏付けに必要な証拠を用いて、提案された選択肢を目的と適用条件に照らして評価する。
記述の評価
要素の整合性と成果の網羅範囲を含め、フレームワークと適用される文脈上の要求に照らして記述を評価する。基準と証拠が、レビュー対象の記述と文脈に適用できることを確認する。根拠となる情報や条件が変わった場合は、影響する判断を再評価する。
曖昧さ、裏付けのない成功条件、適用上の限界を明らかにできる場合は、影響、不確実性、複雑さに見合う労力で、代表的な事例を検討することが望ましい。反例を考える際は、目的、責任、範囲、適用条件を固定する。すべての成果が成立しても目的を果たしていない状況や、ある成果が成立しなくても目的を完全に果たせる状況はあるか。出力が存在し、または処理が成功しても、成果が成立しない状況はあるか。引き受けた仕事を変えたものは元の範囲内の反例ではなく、反例が見つからなくても、すべての事例での十分性を証明したことにはならない。
指摘を、依頼範囲内でのさらなる改訂やレビューに役立てることが望ましい。
指摘を、その証拠と影響範囲とともに報告する。確認された未達成、証拠の不足、根拠のある適用外を区別する。裏付けられた結果と有用な途中作業を保持しつつ、それらを全体の成功と扱わない。レビューでは、提供された記述について本Skillの成果を評価する。欠陥を識別しても、未達成のままの条件が満たされたことにはならない。
統制事項
意味とMarkdownの記述様式にはプロセスフレームワークを適用する。対象がAgent Skillの場合、物理的な形式にはAgent Skills仕様を適用する。これらは、それぞれの対象について必須参照である。変更の範囲は、ユーザーの依頼と利用環境の適用条件が定める。
制約
レビューだけの依頼には、指摘と依頼された修正を返し、求められていない全面改訂を行ってはならない。対象の作業の実行や外部状態の変更には、適用される権限が必要である。未確認の参照や条件は、それに依存する判断や行為を制限しなければならない。独立した作業は、それぞれの適用条件の範囲で続けてよい。
資源
本ファイルは、ルートのSKILL.mdをもとに、その意味と規範強度を維持する日本語訳である。
- 最小テンプレート：Agent Skillを作成する際に使用する。
- 具体例とレビューケース：成功条件の確認、作業詳細の選択、共有情報やビューの記述、不完全な証拠の評価に関係する事例を参照する。
- エージェント作業システムの設計：実現を支える構成、その実装、有効性が依頼対象の場合に用いる。共通の仕事の記述を参照し、構成の設計から前提の問題が見つかった場合は記述を再検討する。