免费在 GitHub 公开

generate-working-docs

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

中文简介正在准备中。当前显示原文说明。

sakamotchi/sql-query-build

查看安装方法

包含的文件（3）

SKILL.md8.1 KB
examples.md2.5 KB
templates.md5.8 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

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

概要

このスキルは、プロジェクトの開発ガイドライン（CLAUDE.mdの開発作業ドキュメント構成）に準拠した開発作業ドキュメント群を docs/working/{YYYYMMDD}_{要件名}/ 配下に自動生成します。

対応する作業タイプ：

新規機能開発
パフォーマンス改善・最適化作業

使用シーン

新規機能開発

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

パフォーマンス改善

パフォーマンスボトルネックの調査・改善時
計測→分析→実装→検証のサイクルを進めたいとき
ベンチマーク結果を記録したいとき

生成ファイル

ファイル	内容（新規機能開発）	内容（パフォーマンス改善）
`requirements.md`	要件定義書。この開発作業で実現したいことを記載	改善要件定義書。現状の問題点と目標値を記載
`design.md`	設計書。実装方針、データ構造、テストコードを記載	最適化設計書。ベンチマーク、ボトルネック分析、最適化方針を記載
`tasklist.md`	タスクリスト。作業項目と進捗状況を管理	タスクリスト。計測→分析→実装→検証の進捗を管理
`task_{タスクID}.md`	各タスクの詳細ドキュメント。必要に応じて作成	各タスクの詳細ドキュメント。必要に応じて作成
`testing.md`	テスト手順書。操作手順で確認する方法を記載	検証手順書。before/after性能比較の方法を記載

実行手順

このスキルが呼び出されたら、以下の手順で実行してください：

1. 作業タイプの判定

ユーザーの要求から作業タイプを判定します：

WBSに「パフォーマンス改善」「高速化」等のキーワードがある → パフォーマンス改善
それ以外 → 新規機能開発

注意: ユーザーに明示的に確認する必要はありません。コンテキストから判断してください。

2. 要件名の確認

ユーザーに要件名を確認します。要件名は英語のケバブケース（例：query-execution, export-csv, optimize-rendering）を推奨します。

3. ディレクトリ作成

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

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

4. サブスキルの順次実行

以下のサブスキルを順次実行します（並列実行禁止）：

generate-requirements - 要件定義書生成
- パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
- ディレクトリパスと要件名、作業タイプを渡す
generate-design - 設計書生成
- パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
- ディレクトリパスと要件名、作業タイプを渡す
- requirements.md を参照して設計を作成
generate-tasklist - タスクリスト生成
- パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
- ディレクトリパスと要件名、作業タイプを渡す
- requirements.md と design.md を参照してタスクを作成
generate-testing - テスト手順書生成
- パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
- ディレクトリパスと要件名、作業タイプを渡す
- requirements.md、design.md、tasklist.md を参照してテスト手順を作成

重要: 各スキルは前のスキルの成果物に依存するため、必ず順次実行してください。

注意:

task_{タスクID}.md は初期生成せず、開発中に必要に応じて作成します。
work_type パラメータは、各サブスキルが適切なテンプレートを選択するために使用されます。

5. 完了報告

生成したディレクトリとファイル一覧をユーザーに報告します。作業タイプ（新規機能開発またはパフォーマンス改善）も明示します。

使用例

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

技術仕様の注意事項

永続化ドキュメントの参照

重要: ドキュメント生成時は、docs/steering/ ディレクトリにある永続化ドキュメントを参照してください。

参照すべきドキュメント

ドキュメント	参照目的
`docs/steering/01_product_requirements.md`	プロダクト全体の要件・機能を確認
`docs/steering/02_functional_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`	プロジェクト用語の正しい使用
`docs/steering/features/*.md`	関連機能の詳細仕様を確認

参照ルール

要件定義書生成時: プロダクト要求定義書と関連する機能詳細仕様を参照
設計書生成時: 技術仕様書、リポジトリ構造定義書、開発ガイドラインを参照
コード例記載時: ユビキタス言語定義書で用語を確認
全ドキュメント生成時: 既存の永続化ドキュメントとの整合性を保つ

Nuxt UI v4 コンポーネント記法

重要: このプロジェクトは Nuxt UI v4 を使用しています。ドキュメント内のコード例では必ず以下の記法を使用してください。

v3 → v4 移行対応表

v3（使用禁止）	v4（使用必須）	説明
`UFormGroup`	`UFormField`	フォームフィールドラッパー
`options` 属性	`items` 属性	USelect, USelectMenu等の選択肢
`v-model`	`v-model`	同じだが、itemsとの組み合わせに注意

正しい記法例（v4）

<template>
  <!-- ✅ 正しい: UFormField + items -->
  <UFormField label="データベース" name="database">
    <USelect v-model="selected" :items="databases" />
  </UFormField>

  <!-- ✅ 正しい: USelectMenu + items -->
  <USelectMenu v-model="selected" :items="options" />
</template>

誤った記法例（v3）

<template>
  <!-- ❌ 間違い: UFormGroup（v3） -->
  <UFormGroup label="データベース">
    <USelect v-model="selected" :options="databases" />
  </UFormGroup>

  <!-- ❌ 間違い: options 属性（v3） -->
  <USelectMenu v-model="selected" :options="options" />
</template>

ドキュメント生成時のルール

コード例には必ず Nuxt UI v4 の記法を使用する
v3 の記法（UFormGroup, options 属性）は絶対に使用しない
既存の CLAUDE.md に記載された技術スタック情報を参照する

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能