Task Specification Creator

Task Specification Creator

概要

ユーザーからの開発タスクを分解し、Phase 1〜Phase 11の実行可能なタスク仕様書を生成するスキル。

核心的な考え方:

1. タスク仕様書を作成することが目的
2. 使用するスキルは仕様書作成時に動的に選定する
3. 現在利用可能なスキル（.claude/skills/）からタスクに適したものを選ぶ
4. タスク完了後はskill-creatorでフィードバックを記録する

ワークフロー

ユーザー要求
    ↓
decompose-task（タスク分解）
    ↓
┌─────────────────────────────────────┐
│ analyze-skills（利用可能スキル確認）│ ← 並列実行
│ identify-scope（スコープ定義）      │
└─────────────────────────────────────┘
    ↓
design-phases（Phase構成設計）
    ↓
generate-task-specs（タスク仕様書生成）
    ↓
┌─────────────────────────────────────┐
│ output-phase-files（ファイル出力）  │ ← 並列実行
│ update-dependencies（依存関係設定） │
└─────────────────────────────────────┘
    ↓
docs/30-workflows/{{機能名}}/phase-*.md
    ↓
Phase 1〜11 実行
    ↓
PR作成・CI通過
    ↓
docs/30-workflows/completed-tasks/{{機能名}}/ へ移動

並列実行グループ

システム仕様参照（aiworkflow-requirements連携）【必須】

タスク仕様書作成時、既存システム仕様との整合性を確保するため aiworkflow-requirements を必ず参照する。

Phase別参照要件

仕様書への記載形式

各Phaseドキュメントの「参照資料」セクションに以下を必ず含める:

### システム仕様（aiworkflow-requirements）

> 実装前に必ず以下のシステム仕様を確認し、既存設計との整合性を確保してください。

| 参照資料 | パス | 内容 |
| -------- | ---- | ---- |
| {{該当する仕様}} | `.claude/skills/aiworkflow-requirements/references/{{ファイル名}}.md` | {{説明}} |

仕様検索: node .claude/skills/aiworkflow-requirements/scripts/search-spec.mjs "{{キーワード}}" 詳細フロー: See references/spec-update-workflow.md

Phase構成（フレームワーク）

タスク仕様書は以下のPhase構成に従って生成する。

Phase別テンプレート: See references/phase-templates.md 出力ディレクトリ構造: See references/artifact-naming-conventions.md

Phase 11: タスク完了処理【必須】

Phase 11でPR作成・CI通過後、タスクディレクトリを完了タスクフォルダに移動する。

タスク完了フロー

Phase 11: PR作成
    ↓
CI通過確認
    ↓
タスクディレクトリを completed-tasks/ に移動
    ↓
（該当する場合）未タスク指示書を削除
    ↓
変更をコミット・プッシュ
    ↓
ワークフロー完了

移動手順

# 1. タスクディレクトリをcompleted-tasksに移動
mv docs/30-workflows/{{タスク名}}/ docs/30-workflows/completed-tasks/

# 2. 移動を確認
ls docs/30-workflows/completed-tasks/ | grep {{タスク名}}

# 3. 変更をコミット
git add docs/30-workflows/
git commit -m "docs(workflows): {{タスク名}}をcompleted-tasksに移動"
git push

未タスク完了時の追加処理

未タスク（unassigned-task）から派生したタスクが完了した場合:

# 1. 完了タスクディレクトリを移動
mv docs/30-workflows/{{タスク名}}/ docs/30-workflows/completed-tasks/

# 2. 元の未タスク指示書を削除（タスク完了のため不要）
rm docs/30-workflows/unassigned-task/task-{{タスクID}}.md

# 3. 変更をコミット
git add docs/30-workflows/
git commit -m "docs(workflows): {{タスク名}}を完了、未タスク指示書を削除"
git push

完了条件チェックリスト

詳細テンプレート: See references/phase-templates.md

Phase 10: 未タスク検出 & 実装ガイド作成【必須】

Phase 10では2つの必須作業を行う:

1. 未タスク検出: 技術的負債の可視化と継続的改善
2. 実装ガイド作成: 概念的説明と技術的詳細のドキュメント化

Phase 10-2: 未タスク検出

詳細仕様: See agents/generate-unassigned-task.md

Phase 10-3: 実装ガイド作成

実装した内容を「概念的な説明」と「技術的な詳細」の両面からドキュメント化する。

ドキュメント要件

記述原則

1. Why-first（なぜ優先）: 「何をしたか」より「なぜそうしたか」を重視
2. 対比説明: 「❌ 悪い例」と「✅ 良い例」を並べて違いを明確化
3. 図解活用: ASCII図でアーキテクチャ・データフロー・関係性を可視化
4. コード注釈: コードスニペットには必ず日本語コメントで意図を補足
5. 読み方併記: 英語の専門用語にはカタカナ読みを付記

テンプレート: See assets/implementation-guide-template.md

出力要件

Task仕様ナビ

実行パターン凡例:

• seq: シーケンシャル（前のTaskに依存）
• par: 並列実行（他と独立）
• cond: 条件分岐の起点
• agg: 集約処理（並列の終点）

詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照 注記: 1 Task = 1 責務。複数責務を1ファイルに入れない。

スキルフィードバック【必須】

各Phase完了時に使用したスキルへのフィードバックを必ず記録する。 これはスキル品質改善・利用状況追跡の中核プロセス。

記録タイミング

記録コマンド

# フィードバック記録（各スキルごとに実行）
node .claude/skills/task-specification-creator/scripts/log_usage.mjs \
  --skill {{skill-name}} --result {{success|failure|partial}} --phase {{phase-number}}

# Phase完了・成果物登録
node .claude/skills/task-specification-creator/scripts/complete-phase.mjs \
  --workflow docs/30-workflows/{{機能名}} --phase {{N}} --artifacts "..."

# スキル仕様準拠チェック（skill-creatorに委譲）
node .claude/skills/skill-creator/scripts/quick_validate.mjs .claude/skills/{{skill-name}}

Phase仕様書への記録形式

各Phase仕様書の「スキルフィードバック記録」セクションに以下を必ず記載:

## スキルフィードバック記録

| スキル          | 結果    | 備考                           |
| --------------- | ------- | ------------------------------ |
| {{skill-name}}  | success | {{使用目的と結果の簡潔な説明}} |

フィードバックフロー: See references/feedback-flow.md

artifacts.json 更新【必須】

各Phase完了時に artifacts.json を必ず更新する。 これはPhase管理・成果物追跡の中核ファイル。

更新タイミング

更新形式

{
  "phases": {
    "N": {
      "status": "completed",
      "completedAt": "2026-01-04T16:00:00Z",
      "artifacts": [
        {
          "type": "document",
          "path": "outputs/phase-N/{{ファイル名}}.md",
          "description": "{{成果物の説明}}"
        }
      ]
    }
  }
}

チェックリスト

Phase完了時に以下をすべて実行すること:

重要: 項目4と5は必須。これらを省略するとワークフロー追跡が破綻する。

詳細: See references/artifact-naming-conventions.md

ベストプラクティス

すべきこと

• 各Phaseを独立したMarkdownファイルとして出力
• タスクに応じて適切なスキルを動的に選定し、選定理由を明記
• Phase完了後に使用したskillをskill-creatorでフィードバック記録
• 各Phase完了時に artifacts.json を必ず更新
• 100人中100人が同じ理解で実行できる粒度で記述
• コード成果物はプロジェクトディレクトリに配置（outputs/ではない）
• TodoWriteでサブタスクを管理し、進捗を可視化

避けるべきこと

• スキルを固定的に決めつける
• スキル選定理由を省略
• skill-creatorでのフィードバック記録を省略
• artifacts.json の更新を忘れる
• 1つのファイルに全Phaseを詰め込む
• コード成果物を outputs/ 配下に配置する

詳細: See references/quality-standards.md

リソース参照

agents/（Task仕様書）

references/（詳細知識）

assets/（テンプレート）

scripts/（決定論的処理）

変更履歴