Task Specification Creator

Task Specification Creator

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

設計原則

クイックスタート

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

ワークフロー概要

createモード

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

📖 references/create-workflow.md

executeモード（Phase 1〜13）

📖 references/execute-workflow.md

リソース一覧

📖 references/resource-map.md

主要エントリポイント

機能別ガイド

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

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

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

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

Task仕様ナビ

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

Phase 12 重要仕様

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

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

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

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

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

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

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

更新が必要な場合:

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

更新が不要な場合:

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

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

# 未タスク検出スクリプト
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完了時の必須アクション

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

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 - 全コマンド一覧

ベストプラクティス

すべきこと

避けるべきこと

フィードバック（必須）

実行後は必ず記録:

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

変更履歴