doc-standard

Installation
SKILL.md

doc-standard スキル

概要

工程ドキュメントの粒度(What/Why と How の分離・トレーサビリティ・検証可能性・NFR 後回し禁止など)を、このディレクトリに同梱したライブラリの原則・レシピ・ルーブリック・機械判定スクリプトを使って 生成し 逸脱チェックする。粒度境界という単一観点に責務を限定する。文章校正・コードレビュー・設計判断記録・完成物レビューは扱わない(後述の委譲先へ)。

本スキルの実装範囲: ライブラリで機械判定対応済みなのは 19 doc_type・WF/agile 両手法=WF: data-design(基本設計=論理データ設計)/ external-design(基本設計=外部設計)/ architecture-design(基本設計=方式設計)/ nonfunctional-design(基本設計=非機能設計)/ operations-design(基本設計=運用/移行設計)/ detailed-design-data(詳細設計=物理データ)/ detailed-design-process(詳細設計=処理詳細=クラス/処理・WF 詳細2本目・data と対)/ srs(要件定義)/ test-case-spec(テストケース仕様)/ test-plan(テスト計画=IEEE 829 系・WF テスト2本目)/ test-design-spec(テスト設計仕様=IEEE 829 系・WF テスト3本目・ケース仕様の直上)/ test-procedure-spec(テスト手順仕様=IEEE 829 系・WF テスト4本目・ケース仕様の直下)/ test-strategy(テスト戦略=組織横断・WF テスト5本目・最上位=テスト工程5レベル完備)、agile: user-story(ユーザーストーリー)/ acceptance-criteria(受入基準=Given-When-Then・agile 2本目)/ design-doc(設計合意文書=Google Style/arc42/C4・agile 3本目)/ adr(Architecture Decision Record・agile 4本目=委譲二重定義の S5 試金石)/ rfc(Request for Comments・agile 5本目=決定前の探索/提案文書・ADR と時間軸で対)/ pr-faq(PR-FAQ=Amazon Working Backwards・agile 6本目=顧客視点の未来プレスリリース+想定問答で企画逆算・agile コア体系の締めくくり)。本スキルが実際に生成・チェックできるのもこの19 doc_type である。基本設計(M3)はデータ設計・外部設計・方式設計・非機能設計・運用/移行設計の5細分すべてが稼働=基本設計 M3 完成。WF テストは戦略/計画/設計仕様/ケース/手順の5レベル完備。詳細設計はデータ/処理の2本。agile の主要成果物(user-story/AC/design-doc/ADR/RFC/PR-FAQ)は出揃い、残る未整備は waterfall/ の他 doc_type 等で今後の拡張だが、本スキルは網羅しているふりをしない。description のトリガ語は将来工程を含むが、未整備工程を要求されたら「レシピ未整備」を告知して生成・チェックを行わない。

いつ何を読むか(遅延参照・ライブラリは常時ロードしない)

同梱ライブラリの各ファイルはこのスキルが発動してから Read する(常時ロードしない=コンテキスト肥大を避ける)。状況別に読むものは以下。パスはすべて、このスキルのディレクトリ(SKILL.md のある場所)からの相対パス。

Installs
1
First Seen
Oct 13, 2026