Eld Spec Discover

コード、テスト、要件、障害資料からELD v5のObservation、Term候補、Law候補を抽出し、出典・抽出確信度・反証事項を付ける。「Law候補を発見して」「語彙を抽出して」「既存コードからSpec候補を調べて」など、Card化前の読み取り専用Discoveryを依頼された時に使用する。候補をaccepted Lawへ自動昇格しない。

CAPHTECH ff8b177 1.7 KB Updated

File contents

ELD Spec Discovery

調査する

  1. 調査目的と対象境界を固定する。
  2. 型、validation、assertion、テスト、エラー処理、API、文書、障害記録を観測する。
  3. 各結果をObservationとしてSource付きで記録する。
  4. 名辞候補をTerm proposal、規範候補をLaw proposalとして分離する。
  5. 既存Cardとの重複、矛盾、廃止済み定義を照合する。

候補を評価する

candidate:
  kind: term | law
  id: <proposal id>
  observation: <実際に確認したこと>
  sources: [<file:line、test、document>]
  extraction_confidence: high | medium | low
  intended_meaning: <Hypothesis。断定しない>
  counterevidence: []
  open_questions: []
  next_action: reject | investigate | decision-proposal

extraction_confidenceはパターン抽出の確からしさであり、規範としての正しさではない。

出力する

  • 調査範囲と未調査範囲
  • Observation一覧
  • Term proposal一覧
  • Law proposal一覧
  • 既存Specとの重複・矛盾
  • Decisionが必要な問い

「コードに存在する」「テストに書かれている」だけでCard化を推奨しない。昇格規則は ../eld/references/20-spec.md を読む。

CAPHTECH/claude-marketplace/tree/main/eld-plugin/skills/eld-spec-discover commit ff8b177dae

Frequently asked questions

npx skillmds@latest add caphtech/eld-spec-discover