[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M734BD937PJSG6TYS2MR40QP":3,"skill-same:01M734BD937PJSG6TYS2MR40QP":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M734BD937PJSG6TYS2MR40QP","dotmet-rules",null,"dotmet の rules ファイルを単体で作成、更新、レビューし、`findings` の主語にしてよい改善対象、分類軸、依存方向、`coverage`、しきい値、設計契約の検出力を判断する。rules の未分類、未適用、`rulesCoverage` の full 化、境界、依存許可、責務境界、しきい値の見直しで使う。解析対象と rules をまとめて整える作業は dotmet-project-config。","mackysoft\u002Fagent-distribution","mackysoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F13536348?v=4","01M734B2PHB14DR8NCDSVFAY3B","Makihiro","01M734B2Q54Q66GC37DHSRHX0F",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fdotmet-rules\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: \"dotmet-rules\"\ndescription: \"dotmet の rules ファイルを単体で作成、更新、レビューし、`findings` の主語にしてよい改善対象、分類軸、依存方向、`coverage`、しきい値、設計契約の検出力を判断する。rules の未分類、未適用、`rulesCoverage` の full 化、境界、依存許可、責務境界、しきい値の見直しで使う。解析対象と rules をまとめて整える作業は dotmet-project-config。\"\n---\n\n# dotmet-rules\n\n## 目的\nrules は dotmet が検査する設計契約である。\nrules ファイルには、`findings` の主語にしてよい改善対象、分類軸、分類条件、依存ルール、`coverage`、しきい値を入れる。\n\n`subjects.owned` は、rules を適用し、`findings` の主語にしてよいソースの境界である。\n解析入力に含まれるソースと、rules を適用するソースは分けて扱う。\n\nJSON を作成または変更する前に [rules JSON 契約](references\u002Frules-contract.md) を読み、必須のルート構造、マッチ条件、依存ポリシーの評価規則を固定する。\n\n## 作業原則\n現在の構造は根拠であり、正しい設計として写す対象ではない。\nrules には、設計契約として検査したい境界を入れる。\n\n作成と更新では、`rulesCoverage = full` だけで完了しない。\n`full` の後に設計契約レビューを行い、主語、分類、許可の検出力を確認する。\n\nrules だけで直せる問題は、確認事項にせず、該当 Phase に戻って修正する。\n確認事項として残せるのは、名称の確定、意図の確認、検出力を弱めない仮判断の確認だけである。\n\n判断を確定できない項目でも、検出力を弱めない仮判断として rules に反映できる場合は反映する。\nその場合は、決めるべきこと、今回 rules での扱い、その扱いの影響を分けて残す。\n\n## 作業のフェーズ\n作成、更新、レビューは同じ Phase で扱う。\n違いは、rules を編集するか、評価結果だけを残すかである。\n\n作成と更新では、`継続` を最終状態にしない。\n`継続` は該当 Phase へ戻るための作業状態として扱う。\nレビューでは、完了条件に達しない状態を評価結果として残してよい。\n\n### Phase 1: 入力と作業種別を固定する\n作業種別、rules のパス、対象コードベースの有無、編集可否を固定する。\nrules の標準配置は `.dotmet\u002Frules.json` とする。\n別配置の rules を扱う場合は、指定されたパスを使う。\n新規作成では [rules JSON 契約](references\u002Frules-contract.md) のコマンドで dotmet のテンプレートを生成し、その構造から編集を始める。\n\n| 作業種別 | 扱い |\n| --- | --- |\n| 作成 | 改善対象、分類軸、分類条件、依存ルール、`coverage` を作り、Phase 8 まで進める。 |\n| 更新 | 既存 rules、現在の構造、設計契約を分けて見て、必要な差分だけ入れる。 |\n| レビュー | rules を変更せず、Phase 8 まで評価し、問題、根拠、必要な差分案、確認事項を残す。 |\n\nこの Phase では、作業種別、rules のパス、対象コードベースの有無、編集可否を残す。\n\n### Phase 2: 改善対象を固定する\nこの Phase では、`findings` の主語にできる範囲を決める。\n分類軸や依存ルールはまだ決めない。\n\n解析入力内のソースを、改善対象、依存ルール上の相手、解析上の根拠、解析対象外に分ける。\n\n| 分類 | 扱い |\n| --- | --- |\n| 改善対象 | `subjects.owned` で定義する。ownership の漏れを独立した条件で検査する必要がある場合だけ `localSubjectsMustBeOwned` を使う。 |\n| 依存ルール上の相手 | `subjects.owned` に入れず、必要な分類だけを与える。 |\n| 解析上の根拠 | 依存解決や判断材料として使うが、rules の主語にしない。 |\n| 対象外 | rules の対象にも依存ルール上の相手にも使わない。 |\n\n改善対象にする根拠は、このプロジェクトで修正責任を持つ対象として説明できることである。\n解析入力に含まれること、依存解決に使うこと、分類に必要なことは根拠にならない。\n\n未分類を減らす目的で、改善対象の境界を広げない。\n検出対象から外す目的で、改善対象のソースを `subjects.owned` から外さない。\n\n解決済みの外部参照と unowned support は、`subjects.external` に列挙しなくても `subject: \"external\"` に一致できる。\n`subjects.external` は外部の相手を明示的な matcher で補足する場合だけ使い、依存先の棚卸しには使わず、`subjects.owned` と重ならない範囲にする。\n\n`localSubjectsMustBeOwned` は、ローカル `subject` のうち `subjects.owned` に含まれることを要求する範囲を、ownership とは独立した条件で指定する。\n`subjects.owned` の代わりに改善対象を定義したり、同じ matcher を複製したりするためには使わない。\n`ownedSubjectsMustClassify` は、`subjects.owned` の `subject` に必要な分類軸だけに使う。\n\nこの Phase では、`subjects.owned` に入れる範囲、入れない範囲、その理由を残す。\n改善対象として仮判断を置ける場合は rules に反映し、確認事項として残す。\n\n### Phase 3: 設計境界を集める\nこの Phase では、改善対象の中にある layer、domain、役割境界を集める。\n現在の構造は根拠として使い、正しい設計としてそのまま写さない。\n\n境界の根拠として、配置、名前、参照方向、公開単位、実行単位、生成元、編集対象、解析上の利用、既存の設計記述を見る。\n単一の根拠だけで境界を確定しない。\n名前空間、assembly、project、directory は境界の根拠であり、それだけで設計境界を探索したことにしない。\n\n設計パターン、役割名、呼び出し方向、状態の所在、入出力の責務、公開契約から生じる役割境界も見る。\n役割境界とは、同じ改善対象の中で分けるべき実装上の役割、依存方向、状態や入出力の責務である。\n\n境界候補は次に分ける。\n\n| 分類 | 扱い |\n| --- | --- |\n| 反映できる境界 | `subjects.owned`、分類軸、依存ルール、`coverage` に反映する。 |\n| rules にあるが保護されていない境界 | 依存ルールまたは `coverage` の不足として扱う。 |\n| 推定できる境界 | 複数の根拠が揃う場合は rules に反映し、残る不確実性を確認事項として残す。 |\n| 確認が必要な境界 | 候補、根拠、影響、決めるべき点を残す。 |\n| 改善対象外の境界 | `subjects.owned` に入れない理由を残す。 |\n\nこの Phase では、rules に反映する境界、確認事項として残す境界、改善対象外にする境界を残す。\n反映できる境界を候補として残すだけで終えない。\n\n### Phase 4: 分類軸と分類条件へ写す\nこの Phase では、Phase 3 で集めた境界を分類軸と分類条件へ写す。\n依存許可は Phase 5 で決める。\n\n分類軸は、設計契約に必要なものだけを定義する。\n未分類を消すための広い受け皿分類を置かない。\n分類軸を採用したら、その軸が何を検出するためのものかを決める。\n\n| 軸 | 役割 |\n| --- | --- |\n| `layer` | 依存方向を表す。 |\n| `domain` | 独立させる責務境界を表す。 |\n| `codeKind` | 異なる分類系統の境界を表す。 |\n\n分類条件は、分類軸が表す境界に合わせて選ぶ。\n物理配置の条件と設計境界の条件を混同しない。\n\n| 分類対象 | 判断 | 優先する条件 |\n| --- | --- | --- |\n| 改善対象 | 修正対象として扱えるソースか。 | `pathPrefix`、`projectExact`、`assemblyExact` |\n| `layer` | 依存方向を持つ役割か。 | `namespacePrefix`、`namespaceExact`、`assemblyExact` |\n| `domain` | 独立させる責務単位か。 | `namespacePrefix`、`assemblyExact`、`projectExact` |\n| `codeKind` | `layer` や `domain` とは別の性質で分けるか。 | `namespacePrefix`、`pathSegment`、`tagExact`、`subjectKindExact` |\n| `subjects.external` | 依存ルール上の相手として区別するか。 | `assemblyExact`、`namespacePrefix` |\n\n`domain` は改善対象の責務境界を表す。\n`subjects.external` の分類は、依存ルール上の相手として区別する範囲に限る。\n改善対象の責務境界と依存先分類を同じ意味で混ぜない。\n\n`pathPrefix` は、改善対象の範囲や物理配置を表す条件として使う。\n`layer`、`domain`、役割境界を `pathPrefix` だけで分類しない。\n\n名前空間、assembly、project、directory が食い違う場合は、どれを設計境界として採用するかを判断する。\n設計境界として採用した根拠と、補助条件として使った根拠を分ける。\n\n分類条件が粗く、禁止したい依存や責務越境を検出できない場合は、rules が成立していても完了にしない。\n\nこの Phase では、分類軸、分類条件、分類条件に使った根拠を残す。\n各分類軸の検査目的を決め、設計境界を表す分類軸を Phase 5 の依存ルールで使える状態にする。\n\n### Phase 5: 検査ルールを書く\nこの Phase では、分類済みの対象に対して依存ルールとしきい値を書く。\n分類軸や改善対象の範囲はここで広げない。\n\n依存ルールは、検出したい境界越境を検出できる粒度で書く。\n現状依存が存在することを、許可する理由にしない。\n\n| 粒度 | 使い方 |\n| --- | --- |\n| `domain` + `layer` | 両方の境界を守る。 |\n| `domain` | `domain` 境界を守る。 |\n| `layer` | `layer` 境界を守る。 |\n| `codeKind` | `codeKind` 境界を守る。 |\n| `subject: \"owned\"` | `subjects.owned` 全体で許可範囲を決める。 |\n\n同一分類内だけを許可する場合も、別の設計境界がその中にあるなら、同値条件または明示許可で依存範囲を狭める。\n許可範囲を広げる判断を置く場合は、検出対象から外れる境界越境を明示する。\n現在の依存を許可するか、目標設計として禁止するかを確定できない場合は、許可範囲へ入れず確認事項として残す。\n\n依存ルールを書いたら、許可グラフとして読む。\nどの分類からどの分類へ依存できるかを確認し、検出したい越境が許可範囲に入っていないことを確認する。\n`subject: \"owned\"` 全体への許可は、設計契約として説明できる場合だけ使う。\n補助的な分類からの依存でも、依存してよい対象を説明できる範囲まで狭める。\n`subject: \"external\"` を広く許可する場合は、改善対象のどの分類からどの外部分類へ依存してよいかを分ける。\n外部依存を一括許可して改善対象内の境界や用途境界を検出できなくなる場合は Phase 5 に留まる。\n\n次の許可は広い許可として扱い、狭められるか確認する。\n\n- `subject: \"owned\"` を使う許可。\n- `subject: \"external\"` を使う許可。\n- 同一分類全体への許可。\n- 補助的な分類から広く依存できる許可。\n\n列挙した許可ごとに、守れる境界、検出できなくなる境界、狭められる条件を残す。\n狭められる許可は狭めてから Phase 6 へ進む。\n\nしきい値は、品質契約がある場合、または既存値を見直す場合だけ扱う。\n新規 rules では、追加する根拠がある場合だけ定義する。\n[rules JSON 契約](references\u002Frules-contract.md) のしきい値規則に従い、組み込み標準を緩める値を採用しない。\n\nこの Phase では、依存ルール、許可範囲、検出対象にした境界越境、しきい値を扱った場合はその目的を残す。\n\n### Phase 6: coverage を検証する\nrules を作成または更新したら、[rules JSON 契約](references\u002Frules-contract.md) に従って `rules validate` のレポートを確認する。\n対象コードベースがある場合は、解析で rules が改善対象へ適用されているか確認する。\n\n[rules JSON 契約](references\u002Frules-contract.md) の意味に従って `rulesCoverage` を読み、`full` を設計契約レビューの通過とはみなさない。\n\nこの Phase では、`rules validate` の結果、`rulesCoverage` の状態、未解消項目と戻り先を残す。\n`rulesCoverage = full` になったら完了せず、Phase 7 へ進む。\n\n### Phase 7: 設計契約レビューを通す\nこの Phase では、`rulesCoverage = full` になった rules の検出力を見る。\n作成と更新では、この Phase に失敗した rules を完了しない。\n\nrules 作成の目的は `findings` を減らすことではない。\n`findings` は、定義した境界が現在のコードに照らして何を検出するかを確認するために使う。\n\n主語、分類、許可の三つを確認する。\n各評価で、通過と判断した根拠を残す。\n根拠には、対象の rules 定義、使われている分類軸、対応する依存ルールを含める。\n根拠を残せない評価は通過扱いにしない。\n\n| 観点 | 通過条件 |\n| --- | --- |\n| 主語 | `subjects.owned` が改善対象だけを含み、改善対象の漏れを `coverage` から外して隠しておらず、依存ルール上の相手を主語にしていない。 |\n| 分類 | 各分類軸に検査目的があり、広い受け皿、異なる役割の混在、物理配置だけの境界、改善対象の責務境界と external 分類の混線がない。 |\n| 許可 | 依存許可グラフを読んだとき、検出したい越境、同一分類内の別境界、用途を限定すべき external 依存が許可範囲に入っていない。 |\n\n分類漏れの検出だけに使われている軸は、境界を保護していない。\n未保護の境界を「次回詳細化」「土台」「確認事項」として残して完了してはならない。\n\nこの Phase では、主語、分類、許可の評価、問題がある場合の原因、必要な差分案を残す。\n\n### Phase 8: 作業状態を残す\nこの Phase では、作業結果を次の判断に使える状態で残す。\nrules の内容はここで新しく判断しない。\n報告では Phase 名を使わない。\nPhase 名は戻り先の判断にだけ使い、報告では改善対象、分類条件、依存許可、coverage、解析対象、コード修正のような作業領域で書く。\n\n| 状態 | 意味 |\n| --- | --- |\n| 完了 | rules が成立し、対象コードベースがある場合は `rulesCoverage` が `full` で、設計契約レビューを通っている。 |\n| 確認事項あり | rules が成立し、対象コードベースがある場合は `rulesCoverage` が `full` で、設計契約レビューを通し、検出力を弱めない確認だけが残っている。 |\n| 継続 | rules の更新だけで解消できる未分類、曖昧な分類、未評価、未適用、分類条件、設計契約レビューの問題が残っている。該当 Phase に戻る。 |\n| 未完了 | rules の更新だけでは完了条件に到達できない原因が残っている。 |\n\n作成と更新では、完了、確認事項あり、未完了のどれかまで進めてから作業を区切る。\n`継続` は戻り先の Phase で処理する。\n未保護の境界、広すぎる許可、改善対象の混入、分類軸の未使用がある場合は `確認事項あり` にしない。\n判断したこと、仮判断、確認が必要なことを分けられない場合は、完了または確認事項ありにしない。\nレビューでは、完了条件に達しない状態を評価結果として扱う。\n\n最後は次の見出しで返す。\n該当がない見出しには、なしと書く。\n\n#### 成果物\n- `subjects.owned` の境界。\n- `subjects.owned` に入れなかった範囲と理由。\n- 採用した分類軸、分類条件、依存ルールの粒度。\n- しきい値を追加または更新した場合は、その目的と影響。\n\n#### 判断したこと\n- 確定した判断。\n- 仮判断として rules に入れたこと。\n- rules に入れなかった候補と理由。\n\n#### 確認が必要なこと\n- 決めるべきこと。\n- 今回 rules ではどう扱ったか。\n- その扱いの影響。\n\n#### 検出力\n- rules で検出できる境界。\n- rules で検出できない境界と理由。\n- 検出される既存の境界越境。\n- 確認事項が残る場合は、それが検出力を弱めない理由。\n\n#### 検証結果\n- 設計契約レビューの結果。\n- `rules validate` の結果。\n- `rulesCoverage` の状態。\n\n#### 次の扱い\n- レビューの場合は、問題、根拠、必要な差分案。\n- `継続` または未完了の場合は、原因と見直す作業領域。\n\n## 戻り先\n作成または更新では、rules だけで直せる問題を確認事項にしない。\n問題が出た場合は、原因に対応する Phase に戻る。\nこの表は作業の制御に使う。\n報告では Phase 名ではなく作業領域を書く。\n\n| 結果 | 戻る場所 | 報告で残す作業領域 |\n| --- | --- | --- |\n| 改善対象の混入、漏れ、または `findings` の主語として説明できない範囲がある。 | Phase 2 | 改善対象の見直し |\n| 設計境界の探索不足、または反映できる境界が候補のまま残っている。 | Phase 3 | 設計境界の見直し |\n| 分類軸の不足、分類条件の粗さ、分類軸の未使用、責務境界と依存先分類の混線がある。 | Phase 4 | 分類条件の見直し |\n| 依存許可が広すぎる、検出したい越境が許可範囲に入っている、現状依存をそのまま許可している。 | Phase 5 | 依存許可の見直し |\n| `rules validate`、`rulesCoverage`、未分類、曖昧な分類、未評価、未適用に問題がある。 | Phase 6 | coverage と検証の見直し |\n| 設計契約レビューで主語、分類、許可のいずれかが通らない。 | Phase 2、Phase 3、Phase 4、Phase 5 の原因箇所 | 設計契約の見直し |\n| 解析対象または target set の問題で rules を適用できない。 | `dotmet-targets` または `dotmet-analysis` | 解析対象の見直し |\n\n## 報告後の再開\nrules への指摘が返った場合は、その指摘を再開入力として扱う。\n指摘内容から戻る場所を判断し、rules を修正する。\nrules を変更した場合は、Phase 6 と Phase 7 を再実行する。\n\n## 完了条件\n作成と更新は、Phase 8 の `完了` または `確認事項あり` の条件を満たし、指定された見出しで判断根拠と検証結果を報告できるまで完了にしない。\nレビューでは、完了条件に達していない点を問題、根拠、必要な差分案として残す。\n","# dotmet-rules\n\n## 目的\nrules は dotmet が検査する設計契約である。\nrules ファイルには、`findings` の主語にしてよい改善対象、分類軸、分類条件、依存ルール、`coverage`、しきい値を入れる。\n\n`subjects.owned` は、rules を適用し、`findings` の主語にしてよいソースの境界である。\n解析入力に含まれるソースと、rules を適用するソースは分けて扱う。\n\nJSON を作成または変更する前に [rules JSON 契約](references\u002Frules-contract.md) を読み、必須のルート構造、マッチ条件、依存ポリシーの評価規則を固定する。\n\n## 作業原則\n現在の構造は根拠であり、正しい設計として写す対象ではない。\nrules には、設計契約として検査したい境界を入れる。\n\n作成と更新では、`rulesCoverage = full` だけで完了しない。\n`full` の後に設計契約レビューを行い、主語、分類、許可の検出力を確認する。\n\nrules だけで直せる問題は、確認事項にせず、該当 Phase に戻って修正する。\n確認事項として残せるのは、名称の確定、意図の確認、検出力を弱めない仮判断の確認だけである。\n\n判断を確定できない項目でも、検出力を弱めない仮判断として rules に反映できる場合は反映する。\nその場合は、決めるべきこと、今回 rules での扱い、その扱いの影響を分けて残す。\n\n## 作業のフェーズ\n作成、更新、レビューは同じ Phase で扱う。\n違いは、rules を編集するか、評価結果だけを残すかである。\n\n作成と更新では、`継続` を最終状態にしない。\n`継続` は該当 Phase へ戻るための作業状態として扱う。\nレビューでは、完了条件に達しない状態を評価結果として残してよい。\n\n### Phase 1: 入力と作業種別を固定する\n作業種別、rules のパス、対象コードベースの有無、編集可否を固定する。\nrules の標準配置は `.dotmet\u002Frules.json` とする。\n別配置の rules を扱う場合は、指定されたパスを使う。\n新規作成では [rules JSON 契約](references\u002Frules-contract.md) のコマンドで dotmet のテンプレートを生成し、その構造から編集を始める。\n\n| 作業種別 | 扱い |\n| --- | --- |\n| 作成 | 改善対象、分類軸、分類条件、依存ルール、`coverage` を作り、Phase 8 まで進める。 |\n| 更新 | 既存 rules、現在の構造、設計契約を分けて見て、必要な差分だけ入れる。 |\n| レビュー | rules を変更せず、Phase 8 まで評価し、問題、根拠、必要な差分案、確認事項を残す。 |\n\nこの Phase では、作業種別、rules のパス、対象コードベースの有無、編集可否を残す。\n\n### Phase 2: 改善対象を固定する\nこの Phase では、`findings` の主語にできる範囲を決める。\n分類軸や依存ルールはまだ決めない。\n\n解析入力内のソースを、改善対象、依存ルール上の相手、解析上の根拠、解析対象外に分ける。\n\n| 分類 | 扱い |\n| --- | --- |\n| 改善対象 | `subjects.owned` で定義する。ownership の漏れを独立した条件で検査する必要がある場合だけ `localSubjectsMustBeOwned` を使う。 |\n| 依存ルール上の相手 | `subjects.owned` に入れず、必要な分類だけを与える。 |\n| 解析上の根拠 | 依存解決や判断材料として使うが、rules の主語にしない。 |\n| 対象外 | rules の対象にも依存ルール上の相手にも使わない。 |\n\n改善対象にする根拠は、このプロジェクトで修正責任を持つ対象として説明できることである。\n解析入力に含まれること、依存解決に使うこと、分類に必要なことは根拠にならない。\n\n未分類を減らす目的で、改善対象の境界を広げない。\n検出対象から外す目的で、改善対象のソースを `subjects.owned` から外さない。\n\n解決済みの外部参照と unowned support は、`subjects.external` に列挙しなくても `subject: \"external\"` に一致できる。\n`subjects.external` は外部の相手を明示的な matcher で補足する場合だけ使い、依存先の棚卸しには使わず、`subjects.owned` と重ならない範囲にする。\n\n`localSubjectsMustBeOwned` は、ローカル `subject` のうち `subjects.owned` に含まれることを要求する範囲を、ownership とは独立した条件で指定する。\n`subjects.owned` の代わりに改善対象を定義したり、同じ matcher を複製したりするためには使わない。\n`ownedSubjectsMustClassify` は、`subjects.owned` の `subject` に必要な分類軸だけに使う。\n\nこの Phase では、`subjects.owned` に入れる範囲、入れない範囲、その理由を残す。\n改善対象として仮判断を置ける場合は rules に反映し、確認事項として残す。\n\n### Phase 3: 設計境界を集める\nこの Phase では、改善対象の中にある layer、domain、役割境界を集める。\n現在の構造は根拠として使い、正しい設計としてそのまま写さない。\n\n境界の根拠として、配置、名前、参照方向、公開単位、実行単位、生成元、編集対象、解析上の利用、既存の設計記述を見る。\n単一の根拠だけで境界を確定しない。\n名前空間、assembly、project、directory は境界の根拠であり、それだけで設計境界を探索したことにしない。\n\n設計パターン、役割名、呼び出し方向、状態の所在、入出力の責務、公開契約から生じる役割境界も見る。\n役割境界とは、同じ改善対象の中で分けるべき実装上の役割、依存方向、状態や入出力の責務である。\n\n境界候補は次に分ける。\n\n| 分類 | 扱い |\n| --- | --- |\n| 反映できる境界 | `subjects.owned`、分類軸、依存ルール、`coverage` に反映する。 |\n| rules にあるが保護されていない境界 | 依存ルールまたは `coverage` の不足として扱う。 |\n| 推定できる境界 | 複数の根拠が揃う場合は rules に反映し、残る不確実性を確認事項として残す。 |\n| 確認が必要な境界 | 候補、根拠、影響、決めるべき点を残す。 |\n| 改善対象外の境界 | `subjects.owned` に入れない理由を残す。 |\n\nこの Phase では、rules に反映する境界、確認事項として残す境界、改善対象外にする境界を残す。\n反映できる境界を候補として残すだけで終えない。\n\n### Phase 4: 分類軸と分類条件へ写す\nこの Phase では、Phase 3 で集めた境界を分類軸と分類条件へ写す。\n依存許可は Phase 5 で決める。\n\n分類軸は、設計契約に必要なものだけを定義する。\n未分類を消すための広い受け皿分類を置かない。\n分類軸を採用したら、その軸が何を検出するためのものかを決める。\n\n| 軸 | 役割 |\n| --- | --- |\n| `layer` | 依存方向を表す。 |\n| `domain` | 独立させる責務境界を表す。 |\n| `codeKind` | 異なる分類系統の境界を表す。 |\n\n分類条件は、分類軸が表す境界に合わせて選ぶ。\n物理配置の条件と設計境界の条件を混同しない。\n\n| 分類対象 | 判断 | 優先する条件 |\n| --- | --- | --- |\n| 改善対象 | 修正対象として扱えるソースか。 | `pathPrefix`、`projectExact`、`assemblyExact` |\n| `layer` | 依存方向を持つ役割か。 | `namespacePrefix`、`namespaceExact`、`assemblyExact` |\n| `domain` | 独立させる責務単位か。 | `namespacePrefix`、`assemblyExact`、`projectExact` |\n| `codeKind` | `layer` や `domain` とは別の性質で分けるか。 | `namespacePrefix`、`pathSegment`、`tagExact`、`subjectKindExact` |\n| `subjects.external` | 依存ルール上の相手として区別するか。 | `assemblyExact`、`namespacePrefix` |\n\n`domain` は改善対象の責務境界を表す。\n`subjects.external` の分類は、依存ルール上の相手として区別する範囲に限る。\n改善対象の責務境界と依存先分類を同じ意味で混ぜない。\n\n`pathPrefix` は、改善対象の範囲や物理配置を表す条件として使う。\n`layer`、`domain`、役割境界を `pathPrefix` だけで分類しない。\n\n名前空間、assembly、project、directory が食い違う場合は、どれを設計境界として採用するかを判断する。\n設計境界として採用した根拠と、補助条件として使った根拠を分ける。\n\n分類条件が粗く、禁止したい依存や責務越境を検出できない場合は、rules が成立していても完了にしない。\n\nこの Phase では、分類軸、分類条件、分類条件に使った根拠を残す。\n各分類軸の検査目的を決め、設計境界を表す分類軸を Phase 5 の依存ルールで使える状態にする。\n\n### Phase 5: 検査ルールを書く\nこの Phase では、分類済みの対象に対して依存ルールとしきい値を書く。\n分類軸や改善対象の範囲はここで広げない。\n\n依存ルールは、検出したい境界越境を検出できる粒度で書く。\n現状依存が存在することを、許可する理由にしない。\n\n| 粒度 | 使い方 |\n| --- | --- |\n| `domain` + `layer` | 両方の境界を守る。 |\n| `domain` | `domain` 境界を守る。 |\n| `layer` | `layer` 境界を守る。 |\n| `codeKind` | `codeKind` 境界を守る。 |\n| `subject: \"owned\"` | `subjects.owned` 全体で許可範囲を決める。 |\n\n同一分類内だけを許可する場合も、別の設計境界がその中にあるなら、同値条件または明示許可で依存範囲を狭める。\n許可範囲を広げる判断を置く場合は、検出対象から外れる境界越境を明示する。\n現在の依存を許可するか、目標設計として禁止するかを確定できない場合は、許可範囲へ入れず確認事項として残す。\n\n依存ルールを書いたら、許可グラフとして読む。\nどの分類からどの分類へ依存できるかを確認し、検出したい越境が許可範囲に入っていないことを確認する。\n`subject: \"owned\"` 全体への許可は、設計契約として説明できる場合だけ使う。\n補助的な分類からの依存でも、依存してよい対象を説明できる範囲まで狭める。\n`subject: \"external\"` を広く許可する場合は、改善対象のどの分類からどの外部分類へ依存してよいかを分ける。\n外部依存を一括許可して改善対象内の境界や用途境界を検出できなくなる場合は Phase 5 に留まる。\n\n次の許可は広い許可として扱い、狭められるか確認する。\n\n- `subject: \"owned\"` を使う許可。\n- `subject: \"external\"` を使う許可。\n- 同一分類全体への許可。\n- 補助的な分類から広く依存できる許可。\n\n列挙した許可ごとに、守れる境界、検出できなくなる境界、狭められる条件を残す。\n狭められる許可は狭めてから Phase 6 へ進む。\n\nしきい値は、品質契約がある場合、または既存値を見直す場合だけ扱う。\n新規 rules では、追加する根拠がある場合だけ定義する。\n[rules JSON 契約](references\u002Frules-contract.md) のしきい値規則に従い、組み込み標準を緩める値を採用しない。\n\nこの Phase では、依存ルール、許可範囲、検出対象にした境界越境、しきい値を扱った場合はその目的を残す。\n\n### Phase 6: coverage を検証する\nrules を作成または更新したら、[rules JSON 契約](references\u002Frules-contract.md) に従って `rules validate` のレポートを確認する。\n対象コードベースがある場合は、解析で rules が改善対象へ適用されているか確認する。\n\n[rules JSON 契約](references\u002Frules-contract.md) の意味に従って `rulesCoverage` を読み、`full` を設計契約レビューの通過とはみなさない。\n\nこの Phase では、`rules validate` の結果、`rulesCoverage` の状態、未解消項目と戻り先を残す。\n`rulesCoverage = full` になったら完了せず、Phase 7 へ進む。\n\n### Phase 7: 設計契約レビューを通す\nこの Phase では、`rulesCoverage = full` になった rules の検出力を見る。\n作成と更新では、この Phase に失敗した rules を完了しない。\n\nrules 作成の目的は `findings` を減らすことではない。\n`findings` は、定義した境界が現在のコードに照らして何を検出するかを確認するために使う。\n\n主語、分類、許可の三つを確認する。\n各評価で、通過と判断した根拠を残す。\n根拠には、対象の rules 定義、使われている分類軸、対応する依存ルールを含める。\n根拠を残せない評価は通過扱いにしない。\n\n| 観点 | 通過条件 |\n| --- | --- |\n| 主語 | `subjects.owned` が改善対象だけを含み、改善対象の漏れを `coverage` から外して隠しておらず、依存ルール上の相手を主語にしていない。 |\n| 分類 | 各分類軸に検査目的があり、広い受け皿、異なる役割の混在、物理配置だけの境界、改善対象の責務境界と external 分類の混線がない。 |\n| 許可 | 依存許可グラフを読んだとき、検出したい越境、同一分類内の別境界、用途を限定すべき external 依存が許可範囲に入っていない。 |\n\n分類漏れの検出だけに使われている軸は、境界を保護していない。\n未保護の境界を「次回詳細化」「土台」「確認事項」として残して完了してはならない。\n\nこの Phase では、主語、分類、許可の評価、問題がある場合の原因、必要な差分案を残す。\n\n### Phase 8: 作業状態を残す\nこの Phase では、作業結果を次の判断に使える状態で残す。\nrules の内容はここで新しく判断しない。\n報告では Phase 名を使わない。\nPhase 名は戻り先の判断にだけ使い、報告では改善対象、分類条件、依存許可、coverage、解析対象、コード修正のような作業領域で書く。\n\n| 状態 | 意味 |\n| --- | --- |\n| 完了 | rules が成立し、対象コードベースがある場合は `rulesCoverage` が `full` で、設計契約レビューを通っている。 |\n| 確認事項あり | rules が成立し、対象コードベースがある場合は `rulesCoverage` が `full` で、設計契約レビューを通し、検出力を弱めない確認だけが残っている。 |\n| 継続 | rules の更新だけで解消できる未分類、曖昧な分類、未評価、未適用、分類条件、設計契約レビューの問題が残っている。該当 Phase に戻る。 |\n| 未完了 | rules の更新だけでは完了条件に到達できない原因が残っている。 |\n\n作成と更新では、完了、確認事項あり、未完了のどれかまで進めてから作業を区切る。\n`継続` は戻り先の Phase で処理する。\n未保護の境界、広すぎる許可、改善対象の混入、分類軸の未使用がある場合は `確認事項あり` にしない。\n判断したこと、仮判断、確認が必要なことを分けられない場合は、完了または確認事項ありにしない。\nレビューでは、完了条件に達しない状態を評価結果として扱う。\n\n最後は次の見出しで返す。\n該当がない見出しには、なしと書く。\n\n#### 成果物\n- `subjects.owned` の境界。\n- `subjects.owned` に入れなかった範囲と理由。\n- 採用した分類軸、分類条件、依存ルールの粒度。\n- しきい値を追加または更新した場合は、その目的と影響。\n\n#### 判断したこと\n- 確定した判断。\n- 仮判断として rules に入れたこと。\n- rules に入れなかった候補と理由。\n\n#### 確認が必要なこと\n- 決めるべきこと。\n- 今回 rules ではどう扱ったか。\n- その扱いの影響。\n\n#### 検出力\n- rules で検出できる境界。\n- rules で検出できない境界と理由。\n- 検出される既存の境界越境。\n- 確認事項が残る場合は、それが検出力を弱めない理由。\n\n#### 検証結果\n- 設計契約レビューの結果。\n- `rules validate` の結果。\n- `rulesCoverage` の状態。\n\n#### 次の扱い\n- レビューの場合は、問題、根拠、必要な差分案。\n- `継続` または未完了の場合は、原因と見直す作業領域。\n\n## 戻り先\n作成または更新では、rules だけで直せる問題を確認事項にしない。\n問題が出た場合は、原因に対応する Phase に戻る。\nこの表は作業の制御に使う。\n報告では Phase 名ではなく作業領域を書く。\n\n| 結果 | 戻る場所 | 報告で残す作業領域 |\n| --- | --- | --- |\n| 改善対象の混入、漏れ、または `findings` の主語として説明できない範囲がある。 | Phase 2 | 改善対象の見直し |\n| 設計境界の探索不足、または反映できる境界が候補のまま残っている。 | Phase 3 | 設計境界の見直し |\n| 分類軸の不足、分類条件の粗さ、分類軸の未使用、責務境界と依存先分類の混線がある。 | Phase 4 | 分類条件の見直し |\n| 依存許可が広すぎる、検出したい越境が許可範囲に入っている、現状依存をそのまま許可している。 | Phase 5 | 依存許可の見直し |\n| `rules validate`、`rulesCoverage`、未分類、曖昧な分類、未評価、未適用に問題がある。 | Phase 6 | coverage と検証の見直し |\n| 設計契約レビューで主語、分類、許可のいずれかが通らない。 | Phase 2、Phase 3、Phase 4、Phase 5 の原因箇所 | 設計契約の見直し |\n| 解析対象または target set の問題で rules を適用できない。 | `dotmet-targets` または `dotmet-analysis` | 解析対象の見直し |\n\n## 報告後の再開\nrules への指摘が返った場合は、その指摘を再開入力として扱う。\n指摘内容から戻る場所を判断し、rules を修正する。\nrules を変更した場合は、Phase 6 と Phase 7 を再実行する。\n\n## 完了条件\n作成と更新は、Phase 8 の `完了` または `確認事項あり` の条件を満たし、指定された見出しで判断根拠と検証結果を報告できるまで完了にしない。\nレビューでは、完了条件に達していない点を問題、根拠、必要な差分案として残す。\n",{"name":5,"description":7},"master","15c74df1ebbd742cd7cc4d24eceea1d34dd1662e",".agents\u002Fskills\u002Fdotmet-rules","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution","https:\u002F\u002Fgithub.com\u002Fmackysoft","Indie game developer and engineer \u002F 11 years of Unity and C# exp. Contact via site","2026-08-15 15:11:49",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add mackysoft\u002Fagent-distribution --skill dotmet-rules",{"tool":37,"command":38},"bunx","bunx skills add mackysoft\u002Fagent-distribution --skill dotmet-rules",{"tool":40,"command":41},"pnpm","pnpm dlx skills add mackysoft\u002Fagent-distribution --skill dotmet-rules","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fdotmet-rules\u002FSKILL.md",true,[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agent-skill.json","REFERENCE","参考文档",1425,"https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fdotmet-rules\u002Fagent-skill.json",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"agents\u002Fopenai.yaml",627,"https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fdotmet-rules\u002Fagents\u002Fopenai.yaml",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Frules-contract.md",5128,"https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fdotmet-rules\u002Freferences\u002Frules-contract.md",[60,66,72,78,84,90],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M734BXCYKYA745PX8P4FPSRM","agent-distribution-verify-changes","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002Ftests\u002FFixtures\u002FSkillBundle\u002Fgenerated\u002Fagent-distribution-verify-changes\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M734BV6ZW4BEYA53BA6ZS1H5","agent-distribution-troubleshoot","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002Ftests\u002FFixtures\u002FSkillBundle\u002Fgenerated\u002Fagent-distribution-troubleshoot\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M734BRW6PM4V7NPD3Y4R11X9","agent-distribution-read-project","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002Ftests\u002FFixtures\u002FSkillBundle\u002Fgenerated\u002Fagent-distribution-read-project\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M734BPJQJFJ1EC4S0WMEZ39D","agent-distribution-plan-apply","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002Ftests\u002FFixtures\u002FSkillBundle\u002Fgenerated\u002Fagent-distribution-plan-apply\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M734BMCS31F885753ZEY649Z","review-context","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002Ftests\u002FFixtures\u002FAgentDistributionBundle\u002Fexpected\u002Fagent-distribution\u002Fskills\u002Freview-context\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M734BGNS1904RRMTQ94RSH10","dotmet-targets","dotmet の target set を単体で定義、更新、レビューし、解析対象、子ターゲット `id`、`adapter`、`solutionPath`、`projectPath`、target set の粒度を判断する。解析対象の固定、パス判断、既存 target set のレビューで使う。target set と rules をまとめて整える作業は dotmet-project-config。","https:\u002F\u002Fgithub.com\u002Fmackysoft\u002Fagent-distribution\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fdotmet-targets\u002FSKILL.md",[],[]]