Skip to content
cccskills
FreePublished on GitHub

spec-template

仕様書作成を支援するテンプレートスキル。docs/specs/ への仕様書作成時に自動適用され、 01_REQUIREMENT_MANAGEMENT.md に準拠した構造を提案する。要件定義、機能仕様、API仕様の作成時に活用される。

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md3.8 KB
  • references/template-api-spec.md1.4 KB
  • references/template-data-model.md764 B
  • references/template-feature-spec.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

仕様書テンプレートスキル

目的

このスキルは、仕様書作成時に一貫した構造と品質を確保するためのテンプレートを提供する。

適用条件

以下のいずれかに該当する場合、このスキルを適用する:

  • docs/specs/ への新規ファイル作成
  • 仕様書、要件定義、機能仕様の作成を求められた
  • API仕様、データモデル定義の作成を求められた

Step 1: 配置を決める

配置は「Milestone に属する仕様一式か、単独の仕様書か」で決まる。

ケース配置例
Milestone の仕様一式(既定)docs/specs/<milestone-slug>/ に requirements.md / design.md / tasks.mddocs/specs/m-1-opus5-migration/requirements.md
単独の仕様書(Milestone に属さない機能・機構)docs/specs/<topic>.md(主題を表す slug / prefix 規約なし)docs/specs/tdd-introspection-v2.md

<milestone-slug> の規約は .claude/rules/terminology.md §4「命名規則」が SSOT。 判断に迷う場合は Milestone ディレクトリ形式に倒す(LAM の現行運用の主形)。

Step 2: テンプレートを選ぶ

requirements.md / 単独仕様書 / その他の仕様文書は、内容の種類でテンプレートを選ぶ。

書く内容テンプレート参照先
機能要件(FR / NFR / スコープ / 受け入れ条件)機能仕様書references/template-feature-spec.md
API エンドポイント定義(リクエスト / レスポンス / エラー)API 仕様書references/template-api-spec.md
データ構造・エンティティ定義データモデル仕様references/template-data-model.md

選んだ 1 種類だけを読むこと。3 つとも読む必要はない。

このスキルが担当しない文書

文書担当
design.md(設計・アーキテクチャ)design-architect サブエージェント
tasks.md(タスク分解)task-decomposer サブエージェント
ADRadr-template スキル

UI 仕様を書く場合

専用テンプレートは持たない。 機能仕様書テンプレートの 「## 5. インターフェース > ### UI(該当する場合)」節に書く。 画面単位で独立した仕様書にする場合も、同テンプレートを土台にする (実例: docs/specs/ui-lam-slides.md)。

Step 3: Definition of Ready チェック

仕様書が完成したら、以下を確認する:

## Definition of Ready チェックリスト

- [ ] **Doc Exists**: docs/specs/ に仕様書が存在する
- [ ] **Unambiguous**: A〜Dの要素が明記され、解釈の揺れがない
  - [ ] Core Value (Why & Who)
  - [ ] Data Model (What)
  - [ ] Interface (How)
  - [ ] Constraints (Limits)
- [ ] **Atomic**: タスクが1 PR単位に分割されている
- [ ] **Testable**: 受け入れ条件がテストコードで表現可能
- [ ] **Reviewed**: 3 Agents Model でレビュー済み

参照ドキュメント

  • docs/internal/01_REQUIREMENT_MANAGEMENT.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ADR(Architecture Decision Record)作成を支援するテンプレートスキル。 docs/adr/ へのADR作成時に自動適用され、 06_DECISION_MAKING.md の3 Agents Modelに準拠した構造を提案する。 アーキテクチャ決定、技術選定、設計方針の記録時に活用される。

The English summary is being prepared. Showing the original description.

sougetuOte/LivingArchitectModel4Updated Sep 8, 2026

AUTONOMOUSフェーズを開始 - 対象 spec を Green State(G1) まで自律実装(MVP/Wave 1)

The English summary is being prepared. Showing the original description.

sougetuOte/LivingArchitectModel4Updated Sep 8, 2026

LAM ダッシュボード HTML を生成し、出力パスを表示する

The English summary is being prepared. Showing the original description.

sougetuOte/LivingArchitectModel4Updated Sep 8, 2026

BUILDINGフェーズを開始 - TDD実装サイクル

The English summary is being prepared. Showing the original description.

sougetuOte/LivingArchitectModel4Updated Sep 8, 2026

新規条項の誕生ゲート(5 宛先の routing 判定 → 常駐集合の予算処理 → 台帳記録)。規範文書に条項を追加・移動・削除するときに実行する

The English summary is being prepared. Showing the original description.

sougetuOte/LivingArchitectModel4Updated Sep 8, 2026

並列監査 + 全修正 + 検証の一気通貫レビュー。--rubric-path=<rubric.md> でゴール条件を注入可能。--auto-approve でサブエージェント向け対話スキップ + 構造化 JSON 出力モード

The English summary is being prepared. Showing the original description.

sougetuOte/LivingArchitectModel4Updated Sep 8, 2026

See all skills by sougetuOte

Report a problem with this skill