sakamotchi/generate-working-docs
.claude/skills/generate-working-docs/SKILL.md
新規機能開発の作業ドキュメントを自動生成します。YYYYMMDD_要件名の形式でディレクトリを作成し、requirements.md、design.md、tasklist.md、testing.mdを生成します。「開発作業ドキュメント作成」「新規開発のドキュメント作って」「ドキュメント生成」などで呼び出されます。パフォーマンス改善作業には generate-performance-docs を使用してください。
$ install --global
skillsauthnpx skillsauth add sakamotchi/sql-query-build generate-working-docsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 10:32 AM4.4s3 files scanned
SKILL.md
- name:
- generate-working-docs
- description:
- 新規機能開発の作業ドキュメントを自動生成します。YYYYMMDD_要件名の形式でディレクトリを作成し、requirements.md、design.md、tasklist.md、testing.mdを生成します。「開発作業ドキュメント作成」「新規開発のドキュメント作って」「ドキュメント生成」などで呼び出されます。パフォーマンス改善作業には generate-performance-docs を使用してください。
開発作業ドキュメント生成スキル（新規機能開発）
概要
このスキルは、新規機能開発のドキュメント群を docs/working/{YYYYMMDD}_{要件名}/ 配下に自動生成します。
パフォーマンス改善・最適化作業には generate-performance-docs を使用してください。
使用シーン
- 新規開発作業の開始時
- 要件定義から実装までを体系的に進めたいとき
- ドキュメント構成を統一したいとき
生成ファイル
| ファイル | 内容 |
|---------|------|
| requirements.md | 要件定義書。この開発作業で実現したいことを記載 |
| design.md | 設計書。実装方針、データ構造、テストコードを記載 |
| tasklist.md | タスクリスト。作業項目と進捗状況を管理 |
| testing.md | テスト手順書。操作手順で確認する方法を記載 |
実行手順
1. 要件名の確認
ユーザーに要件名を確認します。要件名は英語のケバブケース（例：query-execution, export-csv）を推奨します。
2. ディレクトリ作成
本日の日付（YYYYMMDD形式）と要件名を組み合わせてディレクトリを作成します：
mkdir -p docs/working/{YYYYMMDD}_{要件名}
3. ドキュメントの生成
以下の4ファイルをすべて生成します。各テンプレートは templates.md を参照してください。
重要: テンプレートの穴埋めではなく、ユーザーが提供した要件や docs/steering/ の永続化ドキュメントを参照しながら実際の内容を記載してください。
requirements.md の生成
templates.md の「requirements.md テンプレート」を使用して生成します。
参照すべき永続化ドキュメント：
docs/steering/01_product_requirements.md- プロダクト全体の要件・機能を確認docs/steering/02_functional_design.md- 既存の画面・機能設計を参照docs/steering/06_ubiquitous_language.md- プロジェクト用語の正しい使用docs/steering/features/*.md- 関連機能の詳細仕様
design.md の生成
templates.md の「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- 型定義・変数名の用語確認
重要: コード例では Nuxt UI v4 の記法を使用してください。
UFormFieldを使用（UFormGroupは使用禁止）items属性を使用（options属性は使用禁止）
tasklist.md の生成
templates.md の「tasklist.md テンプレート」を使用して生成します。
参照すべき永続化ドキュメント：
docs/steering/04_repository_structure.md- ディレクトリ構造・命名規則を確認docs/steering/05_development_guidelines.md- 開発プロセス・レビュー手順を確認
testing.md の生成
templates.md の「testing.md テンプレート」を使用して生成します。
参照すべき永続化ドキュメント：
docs/steering/01_product_requirements.md- プロダクトの期待される動作を確認docs/steering/02_functional_design.md- UI/UXの仕様を確認docs/steering/05_development_guidelines.md- テスト方針を確認
重要: 可能な限り手動操作で確認する手順を記載し、操作で確認できない項目のみ自動テストを記載します。
task_{タスクID}.md は初期生成せず、開発中に必要に応じて作成します。
4. 完了報告
生成したディレクトリとファイル一覧をユーザーに報告します。
使用例
詳細は examples.md を参照してください。
関連スキル
generate-performance-docs- パフォーマンス改善作業用ドキュメント生成スキルgenerate-requirements- 要件定義書のみを単体再生成するスキルgenerate-design- 設計書のみを単体再生成するスキルgenerate-tasklist- タスクリストのみを単体再生成するスキルgenerate-testing- テスト手順書のみを単体再生成するスキル
関連ドキュメント
CLAUDE.md- 開発作業ドキュメントの構成ルールdocs/- 永続化ドキュメント群
Related Skills
sakamotchi/generate-testing
testing
VerifiedTrustedCommunity
開発作業のテスト手順書（testing.md）を単体で生成・再生成します。全ドキュメントの一括生成には generate-working-docs（新規機能開発）または generate-performance-docs（パフォーマンス改善）を使用してください。
2SKILL.mdUpdated Apr 17, 2026
sakamotchi/generate-tasklist
documentation
VerifiedTrustedCommunity
開発作業のタスクリスト（tasklist.md）を単体で生成・再生成します。全ドキュメントの一括生成には generate-working-docs（新規機能開発）または generate-performance-docs（パフォーマンス改善）を使用してください。
2SKILL.mdUpdated Apr 17, 2026
sakamotchi/generate-requirements
documentation
VerifiedTrustedCommunity
開発作業の要件定義書（requirements.md）を単体で生成・再生成します。全ドキュメントの一括生成には generate-working-docs（新規機能開発）または generate-performance-docs（パフォーマンス改善）を使用してください。
2SKILL.mdUpdated Apr 17, 2026
sakamotchi/generate-project-docs
documentation
VerifiedTrustedCommunity
大規模プロジェクト用のドキュメント群を自動生成します。docs/projects/{プロジェクト名}/配下にproject-plan.md、requirements.md、design.md（全体概要のみ）、wbs.md、implementation-plan.md、および各フェーズごとのdesign.mdを生成します。「プロジェクトドキュメント作成」「大規模機能のドキュメント作って」「プロジェクト計画書を作成」などで呼び出されます。
2SKILL.mdUpdated Apr 17, 2026