Task Specification Creator

開発タスクをPhase 1〜13の実行可能な仕様書に分解・生成。

設計原則

| 原則 | 説明 | | ---- | ---- | | Script First | 決定論的処理はスクリプト（100%精度） | | LLM for Judgment | 判断・創造のみLLM担当 | | Progressive Disclosure | 必要時のみリソース読込 |

クイックスタート

| モード | 用途 | 開始条件 | | ------ | ---- | -------- | | create | 新規タスク仕様書作成 | ユーザーから新規タスク依頼（推奨） | | execute | Phase実行 | タスク仕様書に基づくPhase実行 | | update | 仕様書更新 | 既存仕様書の修正・更新 | | detect-unassigned | 未タスク検出 | Phase 12での残課題検出 |

# モード判定
node scripts/detect-mode.js --request "{{USER_REQUEST}}"

ワークフロー概要

createモード

Phase 1〜3: 分析 → 生成 → 出力
      ↓
Phase 4〜5: 検証 → 完了

📖 references/create-workflow.md

executeモード（Phase 1〜13）

| Phase | 名称 | カテゴリ | | ----- | ---- | -------- | | 1 | 要件定義 | 要件 | | 2 | 設計 | 設計 | | 3 | 設計レビューゲート | ゲート | | 4 | テスト作成 | TDD-Red | | 5 | 実装 | TDD-Green | | 6 | テスト拡充 | 品質 | | 7 | テストカバレッジ確認 | 品質 | | 8 | リファクタリング | TDD-Refactor | | 9 | 品質保証 | 品質 | | 10 | 最終レビューゲート | ゲート | | 11 | 手動テスト検証 | 検証 | | 12 | ドキュメント更新 | 文書化 | | 13 | PR作成 | 完了 |

📖 references/execute-workflow.md

リソース一覧

| カテゴリ | 数 | 詳細参照 | | -------- | -- | -------- | | agents/ | 9 | resource-map.md#agents | | references/ | 15 | resource-map.md#references | | scripts/ | 10 | resource-map.md#scripts | | schemas/ | 8 | resource-map.md#schemas | | assets/ | 8 | resource-map.md#assets |

📖 references/resource-map.md

主要エントリポイント

| 用途 | リソース | | ---- | -------- | | タスク分解 | agents/decompose-task.md | | Phase設計 | agents/design-phases.md | | 仕様書生成 | agents/generate-task-specs.md | | 品質検証 | agents/verify-specs.md | | システム仕様更新 | agents/update-system-specs.md | | 未タスク生成 | agents/generate-unassigned-task.md | | フィードバック | scripts/log-usage.js |

機能別ガイド

| 機能 | 参照先 | | ---- | ------ | | 作成ワークフロー | references/create-workflow.md | | 実行ワークフロー | references/execute-workflow.md | | テストカバレッジ基準 | references/coverage-standards.md | | Phase 11/12ガイド | references/phase-11-12-guide.md | | コマンドリファレンス | references/commands.md | | 品質基準 | references/quality-standards.md | | Phase別テンプレート | references/phase-templates.md | | レビューゲート基準 | references/review-gate-criteria.md | | 仕様更新フロー | references/spec-update-workflow.md | | 技術ドキュメント作成 | references/technical-documentation-guide.md | | 成果物命名規則 | references/artifact-naming-conventions.md | | 未タスクガイドライン | references/unassigned-task-guidelines.md | | 成功/失敗パターン | references/patterns.md | | 自己改善サイクル | references/self-improvement-cycle.md |

システム開発観点チェック

各Phaseでタスクの性質に応じて、以下の観点をAIが判断して確認する：

| 観点 | 仕様参照先（aiworkflow-requirements） | | ---- | ------------------------------------- | | セキュリティ | security-*.md | | UI/UX（Apple HIG） | ui-ux-*.md | | アーキテクチャ | architecture-*.md | | API設計 | api-*.md | | データ整合性 | database-*.md | | エラーハンドリング | error-handling.md | | インターフェース | interfaces-*.md |

Electronデスクトップアプリ観点（本プロジェクト固有）

| 層 | 責務 | 仕様参照先 | | --- | ---- | ---------- | | フロントエンド（Renderer） | UI表示、状態管理 | ui-ux-*.md, interfaces-*.md | | バックエンド（Main） | ビジネスロジック、システムアクセス | architecture-*.md | | IPC通信 | Main-Renderer間通信 | api-*.md, interfaces-*.md | | Preload | セキュアなAPI公開 | security-api-electron.md | | ローカルストレージ | SQLite、ファイル管理 | database-*.md |

📖 詳細: references/quality-standards.md セクション8

Task仕様ナビ

| Task | 責務 | パターン | 入力 | 出力 | | ---- | ---- | -------- | ---- | ---- | | decompose-task | タスクを単一責務に分解 | seq | ユーザー要求 | タスク分解リスト | | identify-scope | スコープ・前提・制約を定義 | seq | タスク分解リスト | スコープ定義 | | design-phases | Phase構成を設計 | seq | スコープ定義 | フェーズ設計書 | | generate-task-specs | タスク仕様書を生成 | seq | フェーズ設計書 | タスク仕様書一覧 | | output-phase-files | 個別Markdownファイルを出力 | par | タスク仕様書一覧 | phase-.md | | update-dependencies | Phase間の依存関係を設定 | par | タスク仕様書一覧 | 依存関係マップ | | verify-specs | 全13仕様書の品質検証 | seq | 検証レポート | PASS/FAIL判定 | | update-system-specs | システム仕様書を更新 | seq | 実装サマリー | 更新完了チェック | | generate-unassigned-task | 未完了タスク指示書を生成 | cond | レビュー課題 | unassigned-task/.md |

凡例: seq=順次実行, par=並列実行, cond=条件分岐

Phase 12 重要仕様

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

| Task | 名称 | 必須 | 詳細参照 | | ---- | ---- | ---- | -------- | | 1 | 実装ガイド作成（2パート構成） | ✅ | 下記参照 | | 2 | システム仕様書更新（2ステップ） | ✅ | 下記参照 | | 3 | ドキュメント更新履歴作成 | ✅ | scripts/generate-documentation-changelog.js | | 4 | 未タスク検出レポート作成 | ✅ | 0件でも出力必須 |

Task 1: 実装ガイドの2パート構成

| パート | 対象読者 | 内容 | | ------ | -------- | ---- | | Part 1 | 初学者・中学生レベル | 概念説明（日常の例え話、専門用語なし） | | Part 2 | 開発者・技術者 | 技術的詳細（スキーマ・API・コード例） |

Part 1（中学生レベル）の必須要件:

日常生活での例え話を必ず含める
専門用語は使わない（使う場合は即座に説明）
「なぜ必要か」を先に説明してから「何をするか」を説明

Part 2（技術者レベル）の必須要件:

インターフェース/型定義（TypeScript）を含める
APIシグネチャと使用例を記載
エラーハンドリングとエッジケースを説明
設定可能なパラメータと定数を一覧化

Task 2: システム仕様更新【2ステップ】

| Step | 必須 | 内容 | | ---- | ---- | ---- | | Step 1 | ✅ | タスク完了記録（1-A: 「完了タスク」セクション追加、1-B: 実装状況テーブル更新） | | Step 2 | 条件 | システム仕様更新（新規インターフェース追加時のみ） |

更新が必要な場合:

新規インターフェース/型の追加
既存インターフェースの変更
新規定数/設定値の追加
API仕様の変更

更新が不要な場合:

内部実装の詳細変更のみ
リファクタリング（インターフェース不変）
バグ修正（仕様変更なし）

Task 4: 未タスク検出（0件でも出力必須）

| ソース | 確認項目 | | ------ | -------- | | Phase 3/10レビュー結果 | MINOR判定の指摘事項 | | Phase 11手動テスト | スコープ外の発見事項 | | コードコメント | TODO/FIXME/HACK/XXX |

# 未タスク検出スクリプト
node scripts/detect-unassigned-tasks.js --scan packages/shared/src --output .tmp/unassigned-candidates.json

📖 references/phase-11-12-guide.md 📖 references/spec-update-workflow.md 📖 agents/generate-unassigned-task.md

重要ルール

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

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

PR作成に関する注意

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

📖 references/commands.md - コマンド一覧

よく使うコマンド

# 全体整合性検証（Phase 5）
node scripts/verify-all-specs.js --workflow docs/30-workflows/{{FEATURE_NAME}}

# Phase完了処理
node scripts/complete-phase.js --workflow docs/30-workflows/{{FEATURE_NAME}} --phase {{N}} --artifacts "outputs/phase-{{N}}/{{FILE}}.md:{{DESCRIPTION}}"

# 未タスク検出（Phase 12）
node scripts/detect-unassigned-tasks.js --scan packages/shared/src --output .tmp/unassigned-candidates.json

# 使用ログ記録
node scripts/log-usage.js --result success --phase "Phase {{N}}"

📖 references/commands.md - 全コマンド一覧

ベストプラクティス

すべきこと

| 推奨事項 | 理由 | | -------- | ---- | | Script優先（決定論的処理） | 100%精度を保証 | | LLMは判断・創造のみ | スクリプトで代替不可能な部分のみ | | Progressive Disclosure | コンテキスト効率化 | | 各Phaseを独立Markdownとして出力 | 管理・追跡の容易さ | | 100人中100人が同じ理解で実行できる粒度 | 実行可能性の保証 | | Phase 12でPart 1を中学生レベルで書く | 非技術者への理解促進 |

避けるべきこと

| 禁止事項 | 問題点 | | -------- | ------ | | 全リソースを一度に読み込む | コンテキスト浪費 | | Script可能な処理をLLMに任せる | 精度・再現性が低下 | | artifacts.json の更新を忘れる | ワークフロー追跡が破綻 | | 曖昧な表現で記述する | 実行可能性が低下 | | Part 1に専門用語を並べる | 中学生に理解されない |

フィードバック（必須）

実行後は必ず記録:

node scripts/log-usage.js --result success --phase "Phase {{N}}"
node scripts/log-usage.js --result failure --phase "Phase {{N}}" --error "{{ERROR_TYPE}}"

変更履歴

| Version | Date | Changes | | ---------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 9.7.0 | 2026-01-26 | 第3次整合性検証修正: SKILL.mdコマンド例修正(complete-phase.js --artifacts追加、detect-unassigned-tasks.js引数修正)、phase-templates.mdファイル名typo修正、spec-update-workflow.md外部スキル拡張子修正(.js→.mjs)、generate-task-specs.md出力先追加、verify-specs.md入力元明記 | | 9.6.0 | 2026-01-26 | 追加整合性修正: identify-scope出力先追加、verification-report.json additionalProperties追加、ファイル名documentation-changelog.md統一 | | 9.5.0 | 2026-01-26 | 全ファイル整合性検証: スキーマ/テンプレート不整合修正(identify-scope, design-phases)、commands.md引数仕様修正、Phase 12 4タスク構成統一、mode.json additionalProperties追加 | | 9.4.0 | 2026-01-26 | 整合性検証修正: identify-scope.mdスキーマ参照修正(scope-definition.json)、phase-templates.mdサブタスク命名統一(Task N)、verify-all-specs.js ESM互換性修正 | | 9.3.0 | 2026-01-26 | skill-creatorリファクタリング: 未リンクreferences 4件を機能別ガイドに追加、commands.mdにgenerate-index.js追加、検証0エラー0警告達成 | | 9.2.1 | 2026-01-26 | アーキテクチャ層別観点をPhase 5（実装）・Phase 12（ドキュメント）テンプレートに追加: 実装ファイル配置・ドキュメント内容の層別ガイド | | 9.2.0 | 2026-01-26 | Electronデスクトップアプリ観点追加: フロントエンド(Renderer)/バックエンド(Main)/IPC/Preload/ローカルストレージの層別チェック観点をPhase 1,2,4テンプレートに追加 | | 9.1.0 | 2026-01-26 | システム開発観点チェック追加: セキュリティ/UI・UX/アーキテクチャ等の多角的観点をPhase共通テンプレートに追加、aiworkflow-requirements連携強化 | | 9.0.2 | 2026-01-26 | Phase 12重要仕様を拡充: Part 2必須要件、未タスク検出、3ステップ仕様更新を追加 | | 9.0.1 | 2026-01-26 | 不足リソース追加: schemas/2, scripts/1, assets/1（合計+4ファイル） | | 9.0.0 | 2026-01-26 | skill-creator v7.0.1準拠: description最適化、情報保持しながらプロンプト圧縮 | | 8.0.1 | 2026-01-26 | resource-map.md参照カウント修正 | | 8.0.0 | 2026-01-26 | skill-creator v7準拠: 597→350行（41%削減） | | 7.13.0 | 2026-01-26 | patterns.md改善: Phase 12出力要件漏れパターン追加、成功パターンにPhase 12出力チェックリスト追加（TASK-3-1-Dフィードバック反映） | | 7.12.0 | 2026-01-25 | spec-update-workflow.md改善: 新規クラス/コンポーネント追加時のチェックリスト追加、「型は別タスクで追加済み」誤判断パターン追加（TASK-3-2フィードバック反映） | | 7.11.0 | 2026-01-25 | spec-update-workflow.md改善: Step 1にLOGS.md・topic-map.md更新手順を追加（Phase 12ドキュメント更新漏れ防止） | | 7.10.1 | 2026-01-25 | unassigned-task-guidelines.md修正: 未タスク検出レポートファイル名をunassigned-task-detection.mdに統一（Phase 12タスク仕様との整合性確保） | | 7.10.0 | 2026-01-25 | spec-update-workflow.md改善: 実装状況テーブル更新を必須アクションとして明記、Step 1-B追加、よくある誤判断パターン表追加（Phase 12誤判断防止強化） | | 7.9.0 | 2026-01-25 | Phase 12仕様ファイル特定ロジック強化: 機能キーワードから仕様ファイルへのマッピング表追加、混同しやすいファイル対照表追加、思考プロセスにステップ0/0.5追加 | | 7.8.0 | 2026-01-23 | update-system-specs.md標準フォーマット化: 5セクション構造化（メタ情報/プロフィール/知識ベース/実行仕様/インターフェース）、思考プロセステーブル追加、patterns.md新規作成 | | 7.7.0 | 2026-01-23 | Phase 12 Step 1検証強化: validate-phase12-step1.js追加、Step 1必須性を「検証タスクでも必須」と明記、検証コマンド使用例追加 | | 7.6.0 | 2026-01-22 | Phase 12テンプレート強化: 完了条件にPhase 12-2の3ステップチェックリスト追加、フォールバック手順セクション追加、spec-update-workflow.md参照リンク追加 | | 7.5.0 | 2026-01-22 | Phase 12改善: Task 2を2ステップ化（タスク完了記録必須＋仕様更新条件付き）、Task 3自動生成スクリプト追加、spec-update-workflow.md明確化 | | 7.4.0 | 2026-01-18 | Phase 12 Task 2強化: システム仕様更新チェックリスト追加、変更タイプ別マッピング追加、更新漏れ防止ガイダンス強化 | | 7.3.0 | 2026-01-17 | Phase 12-2システム仕様更新ガイダンス強化: spec-update-workflow.mdに更新判断基準・フローチャート追加、aiworkflow-requirements更新タイミング明確化 | | 7.2.0 | 2026-01-17 | Phase 11/12実行ガイダンス追加: テスト結果レポート形式、未タスク検出レポート形式（0件含む）、システム仕様書更新手順 | | 7.1.0 | 2026-01-17 | Phase 5「全体整合性検証」追加: verify-all-specs.js（自動13ファイル一括検証）、verify-specs.md（LLM品質検証）、verification-report.json追加 | | 7.0.0 | 2026-01-17 | skill-creator v5.3準拠リファクタリング: Progressive Disclosure完全化、スクリプト拡張子.js統一、リソースマップ整理 | | 6.1.0 | 2026-01-14 | タスク完了ワークフロー追加: unassigned-task→completed-tasks移動・ステータス更新 | | 6.0.0 | 2026-01-13 | skill-creator最新仕様準拠リファクタリング: Script First原則明確化、Progressive Disclosure完全対応、schemas/追加、Self-Improvement基盤追加 | | 5.1.0 | 2026-01-13 | Phase 12-2システムドキュメント更新を強化 | | 5.0.0 | 2026-01-10 | スキル選定機能削除、シンプル化 | | 4.0.0 | 2026-01-06 | Git Worktree削除、結合テストカバレッジ基準追加 | | 3.1.0 | 2026-01-07 | Phase 6追加（テスト拡充）、統合テスト連携必須化 | | 3.0.0 | 2026-01-06 | Phase再構成（1-13）、/ai:diff-to-pr統合 |