Skip to content

非安全系の強調語の平叙化と ui-rules ↔ ui-patterns の重複正本化 #345

Description

@natsuume

概要

安全機構ではない箇所に残る「必ず」等の強調語を平叙形に改め、ui-discipline の閾値・具体例の正本を 1 箇所に定める。

背景

Claude 4.6 以降のモデルは強い強調語で overtrigger しやすく、通常の指示語で足りるというのが公式ガイドの見解 (PR #336 監査)。安全機構 (排他制御・破壊的操作禁止・fail-closed 手順) の強調は意図的として維持し、監査で非安全系と判定された箇所のみを対象とする。

受入基準 (対象と変更内容の全列挙)

  • plugins/agent-discipline/skills/issue-plan/SKILL.md:
    • #N 形式の相互参照を必ず併記します」の「必ず」を削り平叙形にする
    • 境界・異常系導出の「例示に無い境界も…同様に導いてください」の網羅要求ニュアンスを「必要に応じて同様に導出する」程度の条件付き表現に弱める
  • plugins/agent-discipline/skills/issue-start/SKILL.md: Phase A 評価基準の「ケースの網羅表になっているか」を「受入基準と境界・異常系のケースを対応づけた表になっているか」に置き換える
  • plugins/session-handoff/hooks/prompts/handoff-instruction.md: 未コミット変更の「必ず handoff に明記してください」の「必ず」を削る
  • plugins/ui-discipline:
    • boolean prop 閾値 (2 個) の正本を hooks/prompts/ui-rules.md に置き、skills/ui-patterns/SKILL.md 側は数値を書かず ui-rules の boundary への参照にする
    • 定番フォント名 (Inter / Roboto / system fonts) と紫系グラデーションの具体例列挙は ui-patterns/SKILL.md 側のみに残し、ui-rules.md は固有名詞を省いた短文 (「定番フォントの無検討採用と定番配色の既定使用を避ける」相当) にする
  • スコープ外 (変更しない): issue-claim 手順・撤退報告・uncommitted-check・update-default-branch の quote 規約・rebase-workflow の force 禁止など安全機構に分類済みの強調語。ui-rules.md の「共通化必須」「禁止」等の規律本体の modal 語 (意図的 constraint と判定済み)
  • 各規律の意味内容 (何を要求するか) は変えない
  • ui-rules.md の注入サイズは現状以下にする
  • 既存テスト・lint がすべて pass する

I/O 契約

  • 注入・SKILL の配送特性 (SessionStart / SubagentStart / 必要時読込) は変更しない

制約

  • agent-discipline / session-handoff / ui-discipline の version bump (patch) と 4 箇所同期を行う

想定ファイル

  • plugins/agent-discipline/skills/issue-plan/SKILL.md、skills/issue-start/SKILL.md
  • plugins/session-handoff/hooks/prompts/handoff-instruction.md
  • plugins/ui-discipline/hooks/prompts/ui-rules.md、skills/ui-patterns/SKILL.md
  • version 同期 4 箇所 × 3 plugin

関連 issue

親 issue: #341

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3優先度: 低 (文書整備・軽微な改善)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions