Skip to content
cccskills
FreePublished on GitHub

generate-working-docs

開発作業ドキュメントを自動生成します。YYYYMMDD_要件名の形式でディレクトリを作成し、requirements.md、design.md、tasklist.md、testing.mdを生成します。「開発作業ドキュメント作成」「開発ドキュメント作って」「ドキュメント生成」などで呼び出されます。

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

See how to install

Files included (6)

  • SKILL.md4.0 KB
  • examples.md2.4 KB
  • templates/design.md907 B
  • templates/requirements.md767 B
  • templates/tasklist.md701 B
  • templates/testing.md2.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

開発作業ドキュメント生成スキル

概要

このスキルは、開発作業のドキュメント群を docs/working/{YYYYMMDD}_{要件名}/ 配下に自動生成します。

使用シーン

  • 新規開発作業の開始時
  • 要件定義から実装までを体系的に進めたいとき
  • ドキュメント構成を統一したいとき

生成ファイル

ファイル内容
requirements.md要件定義書。この開発作業で実現したいことを記載
design.md設計書。実装方針、データ構造、API設計を記載
tasklist.mdタスクリスト。作業項目と進捗状況を管理
testing.mdテスト手順書。品質確認の手順を記載

実行手順

1. 要件名の確認

ユーザーに要件名を確認します。要件名は英語のケバブケース(例:user-authentication, export-csv)を推奨します。

2. ディレクトリ作成

本日の日付(YYYYMMDD形式)と要件名を組み合わせてディレクトリを作成します:

mkdir -p docs/working/{YYYYMMDD}_{要件名}

3. ドキュメントの生成

以下の4ファイルをすべて生成します。各テンプレートは templates/ 配下のファイルを参照してください。

重要: テンプレートの穴埋めではなく、ユーザーが提供した要件や docs/steering/ の永続化ドキュメントを参照しながら、プロダクトに即した実際の内容を記載してください。

requirements.md の生成

templates/requirements.md を使用して生成します。

参照すべき永続化ドキュメント:

  • docs/steering/01_product_requirements.md - プロダクト全体の要件・機能を確認
  • docs/steering/02_functional_design.md - 既存の画面・機能設計を参照
  • docs/steering/06_ubiquitous_language.md - プロジェクト用語の正しい使用

design.md の生成

templates/design.md を使用して生成します。

参照すべき永続化ドキュメント:

  • docs/steering/03_architecture_specifications.md - 技術スタック・アーキテクチャを確認
  • docs/steering/04_repository_structure.md - ディレクトリ構造・命名規則を確認
  • docs/steering/05_development_guidelines.md - コーディング規約を確認
  • docs/steering/06_ubiquitous_language.md - 型定義・変数名の用語確認

tasklist.md の生成

templates/tasklist.md を使用して生成します。

testing.md の生成

templates/testing.md を使用して生成します。

重要: 人間が実際に操作して確認する手動テストを最優先で記載してください。自動テストは手動で確認が困難な項目に限定します。requirements.md の各機能要件(F-1, F-2...)に対応するテストケースを漏れなく記載してください。

参照すべき永続化ドキュメント:

  • docs/steering/01_product_requirements.md - プロダクトの期待される動作を確認
  • docs/steering/05_development_guidelines.md - テスト方針を確認

task_{タスクID}.md は初期生成せず、開発中に必要に応じて作成します。

4. 完了報告

生成したディレクトリとファイル一覧をユーザーに報告します。

使用例

詳細は examples.md を参照してください。

関連ドキュメント

  • CLAUDE.md - 開発作業ドキュメントの構成ルール
  • docs/steering/ - 永続化ドキュメント群

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

永続化ドキュメント(Steering Documents)を初期生成します。プロダクトのコードを自動解析し、ユーザーへのヒアリングを組み合わせて6種のドキュメントを生成します。併せて generate-working-docs のテンプレートをプロダクト用にカスタマイズします。「永続化ドキュメントを作成して」「steering docs を作って」などで呼び出されます。

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

sakamotchi/spec-driven-starter8Updated Mar 21, 2026

See all skills by sakamotchi

Report a problem with this skill