---

name: task-specification-creator description: | ユーザーから与えられたタスクを単一責務の原則に基づいて分解し、 Phase 1からPhase 13までの実行可能なタスク仕様書ドキュメントを生成する。

Anchors: • Clean Code (Robert C. Martin) / 適用: 単一責務の原則 / 目的: タスク分解の基準 • Continuous Delivery (Jez Humble) / 適用: フェーズゲート / 目的: 品質パイプライン構築 • Domain-Driven Design (Eric Evans) / 適用: ユビキタス言語 / 目的: 一貫した用語設計

Trigger: タスク仕様書作成, タスク分解, ワークフロー設計, 実行計画作成 Use when creating task specifications for complex development tasks. allowed-tools:

• Read
• Write
• Edit
• Bash
• Glob
• Grep
• Task

---

Task Specification Creator

概要

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

設計原則

モード一覧

---

Part 1: タスク仕様書作成ワークフロー（createモード）

CopyPhase 1: 分析（LLM Task）
┌─────────────────────────────────────────────────────────┐
│ decompose-task → identify-scope → design-phases         │
│ 📖 Read: agents/decompose-task.md (必要時)               │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 2: 生成（LLM Task + Script Validation）
┌─────────────────────────────────────────────────────────┐
│ generate-task-specs → [validate-schema]                 │
│ 📖 Read: agents/generate-task-specs.md (必要時)          │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 3: 出力（Script Task - 100%精度）
┌─────────────────────────────────────────────────────────┐
│ [init-artifacts] → [generate-phase-files]               │
│ ┌─────────────────────────────────────────┐              │
│ │ output-phase-files   ← 並列実行          │              │
│ │ update-dependencies ←                  │              │
│ └─────────────────────────────────────────┘              │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 4: 個別検証（Script Task - 100%精度）
┌─────────────────────────────────────────────────────────┐
│ [validate-phase-output]                                 │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 5: 全体整合性検証（Script + LLM - 自動実行）【必須】
┌─────────────────────────────────────────────────────────┐
│ [verify-all-specs] ← 13ファイル一括検証                  │
│     ├── 構造検証: 必須セクション・フォーマット           │
│     ├── 整合性検証: Phase間依存・参照資料               │
│     ├── 品質検証: 曖昧表現・検証可能性                  │
│     └── 完全性検証: 全13 Phase揃っているか              │
│                         ↓                               │
│ verify-specs (LLM) ← 品質基準チェック（必要時）          │
│ 📖 Read: agents/verify-specs.md                         │
│                         ↓                               │
│ 検証レポート生成 → outputs/verification-report.md       │
└─────────────────────────────────────────────────────────┘
                            ↓
         ┌──────────────────┴──────────────────┐
         ↓                                     ↓
    [検証PASS]                            [検証FAIL]
         ↓                                     ↓
Phase 6: 完了                           Phase 2へ戻り修正
┌─────────────────────────────────────────────────────────┐
│ [log-usage] → 完了                                      │
└─────────────────────────────────────────────────────────┘

凡例: [script] = Script Task (100%精度), 無印 = LLM Task

Phase 5 検証項目詳細

---

Part 2: Phase実行ワークフロー

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

Phase実行フロー

CopyPhase N 開始
    ↓
📖 Read: phase-N-*.md（仕様書読み込み）
    ↓
[validate-prerequisites] ← Script Task
    ↓
LLM Task: 仕様書に基づくタスク実行
    ↓
成果物生成
    ↓
[complete-phase] ← Script Task (100%精度)
    ├── artifacts.json 更新
    └── 依存Phase 参照資料 更新
    ↓
[validate-phase-output] ← Script Task
    ↓
Phase N+1 へ

---

Part 3: テストカバレッジ基準

ユニットテストカバレッジ

結合テストカバレッジ

統合テストシナリオカテゴリ

---

Part 4: Progressive Disclosure リソースマップ

リソースは必要な時のみ読み込む。

agents/ （LLM Task仕様）

schemas/ （入出力スキーマ）

references/ （詳細知識）

assets/ （テンプレート）

scripts/ （決定論的処理 - 100%精度）

---

Part 5: 実行コマンドリファレンス

全体整合性検証【Phase 5 - 必須】

Copy# 13ファイル一括検証（Script Task - 100%精度・自動実行）
node .claude/skills/task-specification-creator/scripts/verify-all-specs.js \
  --workflow docs/30-workflows/{{FEATURE_NAME}}

# 厳格モード（警告もエラーとして扱う）
node .claude/skills/task-specification-creator/scripts/verify-all-specs.js \
  --workflow docs/30-workflows/{{FEATURE_NAME}} \
  --strict

# JSON形式で出力
node .claude/skills/task-specification-creator/scripts/verify-all-specs.js \
  --workflow docs/30-workflows/{{FEATURE_NAME}} \
  --json

検証結果: outputs/verification-report.md に出力 判定: PASS → Phase 6（完了）へ / FAIL → Phase 2へ戻り修正

Phase出力検証

Copy# Phase出力の検証（Script Task - 100%精度）
node .claude/skills/task-specification-creator/scripts/validate-phase-output.js \
  docs/30-workflows/{{FEATURE_NAME}} \
  --phase {{PHASE_NUMBER}}

Phase完了処理

Copy# Phase完了・成果物登録（Script Task - 100%精度）
node .claude/skills/task-specification-creator/scripts/complete-phase.js \
  --workflow docs/30-workflows/{{FEATURE_NAME}} \
  --phase {{PHASE_NUMBER}} \
  --artifacts "outputs/phase-{{PHASE_NUMBER}}/{{FILE}}.md:{{DESCRIPTION}}"

未タスク検出

Copy# コードベースからTODO/FIXME検出（Script Task - 100%精度）
node .claude/skills/task-specification-creator/scripts/detect-unassigned-tasks.js \
  --workflow docs/30-workflows/{{FEATURE_NAME}} \
  --sources "packages/,apps/"

---

Part 6: システム仕様参照（aiworkflow-requirements連携）

Phase別参照要件

システム仕様更新ガイドライン

Phase 12でシステム仕様の更新が必要かを判断する際は、以下を参照:

📖 spec-update-workflow.md: 更新判断基準・フローチャート

仕様書への記載形式

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

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

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

| 参照資料      | パス                                                                 | 内容                 |
| ------------- | -------------------------------------------------------------------- | -------------------- |
| {{SPEC_NAME}} | `.claude/skills/aiworkflow-requirements/references/{{SPEC_FILE}}.md` | {{SPEC_DESCRIPTION}} |

---

Part 7: 重要ルール

Phase完了時の必須アクション

各Phase完了時に以下を必ず実行すること:

1. タスク完全実行: Phase内で指定された全タスクを完全に実行
2. 成果物確認: 全ての必須成果物が生成されていることを検証
3. artifacts.json更新: complete-phase.js でPhase完了ステータスを更新
4. 完了条件チェック: 各タスクを完遂した旨を必ず明記

PR作成に関する重要な注意

PR作成は自動実行しない。必ずユーザーの明示的な許可を得てから実行すること。

ローカル確認チェックリスト（PR作成前に必須）

---

Part 8: ベストプラクティス

すべきこと

避けるべきこと

---

Part 9: Task仕様ナビ

実行パターン凡例:

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

---

Part 10: Phase 11/12 実行ガイダンス

Phase 11: 手動テスト検証

実行フロー

Copy1. 関連する自動テストを全て実行して確認
   ↓
2. テストカテゴリを特定（機能/エラーハンドリング/アクセシビリティ/統合）
   ↓
3. 各カテゴリのテスト項目を実行・記録
   ↓
4. 結果を outputs/phase-11/manual-test-result.md に出力
   ↓
5. 発見課題を outputs/phase-11/discovered-issues.md に出力

テスト結果レポート形式

Copy## テストカテゴリ別結果

### 機能テスト（正常系）

| TC-ID  | 機能       | 期待結果           | 結果 | 備考 |
| ------ | ---------- | ------------------ | ---- | ---- |
| TC-001 | {{機能名}} | {{期待される動作}} | PASS |      |

### エラーハンドリングテスト（異常系）

| TC-ID  | 状況         | 期待結果             | 結果 | 備考 |
| ------ | ------------ | -------------------- | ---- | ---- |
| TC-101 | {{異常状況}} | {{期待されるエラー}} | PASS |      |

### アクセシビリティテスト

| TC-ID  | 要件                     | 結果 | WCAG違反 |
| ------ | ------------------------ | ---- | -------- |
| TC-201 | キーボードナビゲーション | PASS | なし     |

### 統合テスト連携

| テスト項目 | 結果 | 課題有無 |
| ---------- | ---- | -------- |
| IPC接続    | PASS | なし     |

Phase 12: ドキュメント更新

必須タスク（4タスク - 全て完了必須）

Task 1: 実装ガイド作成（2パート構成必須）

• Part 1: 概念的説明（初学者・非技術者向け）
• Part 2: 技術的詳細（開発者向け）

Task 2: システム仕様書更新（aiworkflow-requirements）【重要】

• 📖 必須: references/spec-update-workflow.md を読み込む

⚠️ 2ステップで実行:

Step 1: タスク完了記録（必須 - 全タスク共通）

Copy□ 該当する仕様書に「## 完了タスク」セクションを追加
□ 「## 関連ドキュメント」に実装ガイドリンクを追加

Step 2: システム仕様更新（条件付き）

• 更新判断基準に基づき更新要否を判断
• 不要の場合: documentation-changelog.mdに「更新なし」を明記
• 必要な場合: 以下のチェックリストを実行

  Copy□ メソッドシグネチャ変更 → interfaces-*.md
  □ 新規エラークラス追加 → error-handling.md
  □ 新規ビジネスルール → interfaces-*.md
  □ 認可/認証ロジック → interfaces-*.md / security-*.md
  □ 新規定数/設定値 → 該当interfaces-*.md
  □ DBスキーマ変更 → database-*.md
  □ 更新したファイルの変更履歴にバージョン追記
  

Task 3: ドキュメント更新履歴作成

• 自動生成スクリプトを使用（推奨）:

  Copynode .claude/skills/task-specification-creator/scripts/generate-documentation-changelog.js \
    --workflow docs/30-workflows/{{FEATURE_NAME}}
  

• 生成後、手動で以下を補完:
  • システム仕様更新内容または「更新なし」の判断根拠
  • ソースコード変更の概要

Task 4: 未タスク検出レポート作成（0件でも出力必須）

• FAILテスト、重要度「高」課題、WCAG違反を検出
• 検出されなくても「検出タスクなし」と明記

未タスク検出レポート形式（0件の場合）

Copy## 検出結果サマリー

| ソース           | 検出数  |
| ---------------- | ------- |
| テスト結果       | 0件     |
| 発見課題         | 0件     |
| アクセシビリティ | 0件     |
| **合計**         | **0件** |

## 検出タスク一覧

**検出タスクなし**

すべてのテストがPASSし、発見課題もないため、未タスクとして記録すべき項目はありません。

---

変更履歴