generate-working-docs

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

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

概要

このスキルは、開発作業のドキュメント群を 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/ - 永続化ドキュメント群