CAPHTECH Requirements Author
Overview
自然言語の要件を、そのまま比較しない。 1要件ごとに観測可能で検査可能な YAML に正規化し、後続のカタログ管理、トレーサビリティ、検査、手動テストへ渡せる形にする。
Workflow
Step 1: 入力を要件単位に分解する
新機能の説明、会議メモ、Issue、既存仕様の文章を読み、1つの保証ごとに分ける。 1レコードに複数の保証や複数の禁止事項を無理に混ぜない。
Step 2: YAML へ正規化する
項目定義と必須欄は references/requirements-yaml-schema.md を読む。 出力は assets/templates/requirement.yaml を土台にし、同スキーマの必須欄と推奨欄をすべてそろえる。
observable と negative_examples がない要件は未完成として扱う。
Step 3: 曖昧さを露出する
埋められない欄を推測で埋めない。 代わりに次を明示する。
unknowns: 未決定事項assumptions: 仮定した内容questions_for_review: 確認したい点
Step 4: 要件IDを振る
ID規則は references/requirements-yaml-schema.md を使う。
既存の系列があればそれに合わせ、なければ REQ-<domain>-<nnn> を使う。
Step 5: 次の運用先を示す
作成した YAML を次のスキルへ渡す。
- 要件一覧化やトレース接続:
/requirements-traceability - 欠落や矛盾の検査:
/requirements-inspector - 手動確認手順の生成:
/requirements-manual-test
Output Contract
- 要件 YAML 本文
- 要件ごとの
unknowns - 要件ごとの
assumptions - 追加確認が必要な質問
Stop Conditions
以下に当たったら完成扱いにしない。
observableが書けないnegative_examplesが書けない- 1つの要件に複数の独立保証が混ざっている
- 実装や運用で観測できる手段がまったくない