spec-checklist
Skill1 starsChanged 2 months agoMITView on GitHub
設計書と計画の品質を実装前に検査する。/ml-pipeline 手順3.3 で自動実行。「設計書をチェックして」でも使う。
1 other project uses a version of this.
Adopted by
Most recently taken up by
- xfstudio/skillstheir own version, first seen Oct 13, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- xfstudio/skills★ 9same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository27 other files it gives its agents.
- AGENTS.mdAGENTS.md
- adrSkill
- architecture-checkSkill
- brainstormSkill
- branch-namingSkill
- codex-delegateSkill
- config-explainSkill
- config-setSkill
- cross-reviewSkill
- design-interviewSkill
- diagnosing-bugsSkill
- fix-ciSkill
- handoffSkill
- leakage-checkSkill
- literature-reviewSkill
- mlflow-logSkill
- multi-seedSkill
- mutation-testSkill
- paper-writingSkill
- pre-mortemSkill
- property-testSkill
- python-standardsSkill
- refactor-scoutSkill
- regression-suiteSkill
- retrospectiveSkill
- security-reviewSkill
- tddSkill
The file
Files
設計書品質チェックリスト
「コードが動くか」ではなく「設計書自体が良く書けているか」を検査する。 /ml-pipeline では Planner の計画作成後に必ず自動実行される(手順3.3)。 単独でも「設計書をチェックして」で呼べる。
検査対象
- 設計書がある場合: docs/drafts/ または docs/active/ 配下の設計書 + Planner の計画 (トレーサビリティ表が全 R-ID を覆っているかもカバレッジ次元で見る)
- 設計書が無い場合(直接依頼のパイプライン): Planner の計画そのものを検査する。 このとき「完全性」は計画の検証方法・リスクセクションに対して、 「カバレッジ」はトレーサビリティ表ではなく「全ステップに検証方法があるか」に読み替える
検査の5次元
各次元について、設計書(または計画)の該当箇所を引用しながら判定する。
| 次元 | 検査内容 | 例 |
| 完全性 | 曖昧性タクソノミーの全カテゴリ(境界値・同一性・解決・例外系・状態・順序・データ・非機能・スコープ境界・既存契約。研究系なら仮説・変数・ベースライン・成功基準・再現性も)に答えが書かれているか。同一性・解決に該当する要件が操作形でなく不変条件として書かれ、同値クラス表が添付されているか | 「NaN 入力時の挙動が書かれていない」「パス照合の要件が『cwd 基準に変更する』という操作形のままで、symlink 等の同値クラスが未定義」 |
| 明確性 | 解釈が一意か。「適切に」「なるべく」「高速に」「必要に応じて」等の曖昧語が残っていないか | 「『十分な精度』→ 数値で定義されていない」 |
| 一貫性 | 設計書内で矛盾する記述が無いか。用語が CONTEXT.md と一致しているか | 「§2 では bag 単位、§4 ではインスタンス単位と書かれている」 |
| 測定可能性 | 受け入れ条件テーブルの全要件が、実行コマンドまたは明確な目視基準で検証可能か。期待結果が機械照合できる形式か。計画に『事後条件』欄があり、各事後条件が実行コマンドで機械照合できる形か(実装を見る前に固定できる内容になっているか) | 「R-003 の期待結果『改善する』→ 数値条件になっていない」/「PC-2 の満たすべき条件が『問題なく動く』→ 機械照合できる形になっていない」 |
| カバレッジ | 本文に書かれた全ての決定・要件が、受け入れ条件テーブルの R-ID に対応しているか(本文にあるのにテーブルに無い要件は漏れ) | 「§3 の seed 固定の記述に対応する R-ID が無い」 |
進め方
- 作業スコープ直下に CONTEXT.md があれば先に読む。
- 対象の設計書(無ければ Planner の計画)を読み込む。
- 5次元を1つずつ順に検査する(複数を同時に浅く見ない)。
- 指摘には必ず設計書(または計画)の該当箇所(セクション名や引用)を添える。
出力形式
設計書品質チェック結果
- 対象: <設計書のパス。設計書が無い場合は計画ファイルのパス>
- 総合判定: READY(指摘なし or LOW のみ) / NEEDS_WORK(MEDIUM 以上あり)
| 次元 | 判定 | 指摘 |
| 完全性 | OK / NG | [重大度] 指摘内容(該当箇所) |
| 明確性 | OK / NG | ... |
| 一貫性 | OK / NG | ... |
| 測定可能性 | OK / NG | ... |
| カバレッジ | OK / NG | ... |
重大度の基準:
- HIGH: このまま実装すると手戻りがほぼ確実(受け入れ条件の検証不能、本文とテーブルの矛盾)
- MEDIUM: 実装中に質問が発生する(カテゴリの未回答、曖昧語)
- LOW: あった方が良い(補足の不足)
NEEDS_WORK の場合の後続処理は /ml-pipeline の手順3.3 が制御する (design-interview の必須実行)。単独実行時のみ 「design-interview で残りを詰めますか?」と提案する。
重要なルール
- 設計書を勝手に修正しない(検査とレポートのみ)。修正は design-interview 経由で行う
- 設計の中身の良し悪し(この方式が最適か)は判定しない。それはユーザーと brainstorm / design-interview の仕事。ここでは「書き方の品質」だけを見る
- 書き捨てスクリプトや軽微な修正の設計書に完璧を求めない。設計書の規模に 応じた指摘をする(1画面の設計書に非機能要件の欠如を HIGH にしない)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

