Skip to content
cccskills
FreePublished on GitHub

dev:developing

task-list.jsonのタスクを実行。workflowフィールド(tdd/e2e/task)に応じたワークフローで実装。Trigger: dev:developing, /dev:developing, 実装, 開発, implementing, develop

The English summary is being prepared. Showing the original description.

See how to install

Files included (9)

  • SKILL.md10.4 KB
  • agents/quality-check.md1.5 KB
  • agents/spot-fix.md2.3 KB
  • agents/spot-review.md5.2 KB
  • agents/tdd-cycle.md4.7 KB
  • agents/tdd-review.md5.9 KB
  • references/learnings-footer.md962 B
  • scripts/build-prompt.sh969 B
  • scripts/init-learnings.sh1.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

実装(dev:developing)

実行方法

ワークフロー別の実行方法:

  • TDD: 各ステップは Task エージェントに委譲する(実装・テスト・レビューは独立性が高い)
  • E2E/TASK: メインで直接実行し、CHECK/SPOT/FIX のみ Task エージェントに委譲する

エージェント呼び出しパターン

scripts/build-prompt.sh でプロンプトを自動構築する。agent本文 + 追加コンテキスト + LEARNINGS_FOOTER が一括で組み立てられる。

prompt = Bash("bash scripts/build-prompt.sh {agent} $LEARNINGS_PATH \"タスク: {name}\n{description}\"")
Task({ prompt, subagent_type: "general-purpose", model: {指定モデル} })

エラーハンドリング

エージェントが❌(FAILED)を返した場合:

  1. エラー内容を確認
  2. 修正可能なら前のステップに戻って再実行(例: CHECK失敗 → CYCLE に戻る)
  3. 同じステップが合計3回失敗 → ユーザーに状況を報告し、指示を仰ぐ

エスカレーション報告形式: 「{タスク名}の{ステップ名}が3回失敗しました。{エラー要約}。どう対応しますか?」

ワークフロー別ステップ・委譲先

TDDワークフロー(workflow: tdd)

Stepagentmodeltype備考
1 CYCLEtdd-cycle.mdopusgeneral-purposeRED→テストcommit→GREEN→REFACTOR(+OpenCode)
2 REVIEWtdd-review.mdsonnetgeneral-purpose過剰適合・抜け道(+OpenCode) + テスト資産管理。問題→Step 1へ
3 CHECKquality-check.mdhaikugeneral-purposelint/format/build
4 SPOTspot-review.mdsonnetgeneral-purposecommit後の即時レビュー(+OpenCode)
4b FIXspot-fix.mdopusgeneral-purposeSPOT FAIL時のみ: 修正→CHECK→再SPOT(最大3回)

E2Eワークフロー(workflow: e2e)

CHECK/SPOT/FIX以外はサブエージェント呼び出しなし。メインが直接実行。

Stepagentmodeltype備考
1 IMPL---メインが直接UI実装
2 AUTO---メインが agent-browser CLI で直接検証
2b FIX---AUTO NG時: メインが直接修正(最大3回)
3 CHECKquality-check.mdhaikugeneral-purposelint/format/build
4 SPOTspot-review.mdsonnetgeneral-purposecommit後の即時レビュー(+OpenCode)
4b FIXspot-fix.mdopusgeneral-purposeSPOT FAIL時のみ: 修正→CHECK→再SPOT(最大3回)

IMPL→AUTO→FIX ループ実行手順:

# Step 1 IMPL(メイン直接実行)
# メインが直接 Read/Write/Edit でUI実装する

# Step 2 AUTO + FIX ループ(メイン直接実行)
fix_count = 0
loop:
  # agent-browser CLI で直接検証
  Bash("agent-browser open <対象URL>")
  Bash("agent-browser snapshot -i")        # 対話要素確認
  Bash("agent-browser screenshot <path>")  # スクリーンショット取得
  # 操作・検証を実行し、結果を評価
  Bash("agent-browser close")

  if 検証OK → break
  fix_count += 1
  if fix_count >= 3 → エスカレーション → break

  # Step 2b FIX(メイン直接実行)
  # 検証で見つかった問題をメインが直接修正
  goto loop

# Step 3 CHECK, 4 SPOT/FIX は共通フロー(Task委譲、テーブル通り)

TASKワークフロー(workflow: task)

SPOT/FIX以外はサブエージェント呼び出しなし。エージェントが直接実行。

Stepagentmodeltype備考
1 EXEC---エージェントが直接実行(設定ファイル作成、コマンド実行など)
2 VERIFY---検証(ファイル存在確認、ビルド確認など)
3 SPOTspot-review.mdsonnetgeneral-purposecommit後の即時レビュー(+OpenCode)
3b FIXspot-fix.mdopusgeneral-purposeSPOT FAIL時のみ: 修正→再SPOT(最大3回)

実行プロセス

Phase 0: 計画選択

  1. ユーザーが直接ディレクトリパスを渡している場合:
    • そのディレクトリ内の task-list.json と story-analysis.json を読み込む
    • Read で存在確認し、直接 Phase 1 へ
  2. Glob("docs/FEATURES/**/task-list.json") で検索
  3. 0件 → 「先に /dev:story を実行してタスクリストを作成してください。」と案内して終了
  4. 各ファイルを Read し、metadata.status が "completed" のものを除外(未定義は "pending" 扱い)
  5. 残った候補を AskUserQuestion でユーザーに選択させる:
    • 1件: 確認(「この計画を実行しますか?」)
    • 2件以上: リスト選択(タスク数・TDD/E2E/TASK内訳を表示)
  6. 選択されたディレクトリを $STORY_DIR として確定。$STORY_DIR/task-list.json を $TASK_LIST とする

ゲート: $TASK_LIST が確定していなければ次に進まない。

Phase 1: タスク登録 + コンテキスト読み込み + LEARNINGS.md 作成

  1. $TASK_LIST を読み込み、全タスクを TaskCreate で登録
  2. 依存関係があれば TaskUpdate(addBlockedBy) で設定
  3. TaskList で登録確認
  4. story-analysis.json の読み込み: $STORY_DIR/story-analysis.json を Read し、$STORY_ANALYSIS として保持する
    • goal: ストーリーの達成目標
    • scope.included / scope.excluded: スコープ境界(実装時のスコープクリープ防止に使用)
    • story-analysis.json が存在しない場合はスキップ(下位互換)
  5. LEARNINGS.md を作成:
    bash scripts/init-learnings.sh <ストーリーディレクトリ>
    
  6. $LEARNINGS_PATH を作成した LEARNINGS.md の絶対パスに設定

ゲート: タスクが登録され、LEARNINGS.md が作成されていなければ次に進まない。

Phase 2: タスク実行(workflow別ワークフロー)

planPath 参照: task-list.json の context.planPath が存在する場合:

  1. Phase 2 開始時に planPath を Read し、当該ストーリーの設計情報(acceptanceCriteria, technicalNotes 等)を $PLAN_CONTEXT として保持する
  2. サブエージェント呼び出し時、タスクの実装にストーリー全体の設計情報が必要な場合は build-prompt.sh の追加コンテキストに $PLAN_CONTEXT を含める。その際、用途を明示するヘッダーを付けること:
    prompt = Bash("bash scripts/build-prompt.sh {agent} $LEARNINGS_PATH \"タスク: {name}\n{description}\" \"## 全体計画(設計判断・スコープ確認に参照)\n$PLAN_CONTEXT\"")
    
  3. メイン自身も実装方針やスコープ判断に迷った際に planPath を参照する

story-analysis.json 参照: $STORY_ANALYSIS が存在する場合:

  • scope.excluded をスコープクリープ防止のガードレールとして使用。タスク実装中に scope 外の変更を行おうとしていないか確認する
  • goal をタスクの実装判断(方針に迷った際の判断基準)に使用する
  • サブエージェントへの追加コンテキストとしては通常不要(task-list.json の context で十分)。ただし、スコープの判断が難しいタスクでは scope 情報を追加コンテキストに含めてよい

E2E環境セットアップ(E2Eタスクが存在する場合、Phase 2開始前に1回実行)

bash ".claude/skills/dev/agent-browser/setup-agent-browser.sh"
  • SUCCESS:<prefix> → agent-browser CLI 使用可能
  • FAIL:<reason> → AskUserQuestion で <reason> を報告して中断

タスク実行

  1. 各タスクの workflow フィールドに応じて上記「ワークフロー別ステップ・委譲先」を適用
  2. build-prompt.sh を使って LEARNINGS_FOOTER を全 Task 呼び出しに自動付与する
  3. 各タスク完了時に TaskUpdate(completed)

ゲート: 全タスクが完了しなければ次に進まない。

Phase 3: 計画ステータス更新

全タスク完了後、$TASK_LIST の metadata.status を "completed" に更新して Write で保存する。 これにより次回の計画選択時に候補から除外される。


完了条件

  • すべてのtaskワークフローが完了(EXEC→VERIFY→SPOT)
  • すべてのtddワークフローが完了(CYCLE→REVIEW→CHECK→SPOT)
  • すべてのe2eワークフローが完了(IMPL→AUTO→CHECK→SPOT)
  • 全テストが成功
  • 品質チェックが通過
  • spot-reviewがパス(または3回失敗でエスカレーション)
  • LEARNINGS.md がストーリーディレクトリに存在する

参照

  • agents/: tdd-cycle.md, tdd-review.md, quality-check.md, spot-review.md, spot-fix.md
  • scripts/: build-prompt.sh, init-learnings.sh
  • references/: learnings-footer.md
  • rules/: workflow/workflow-branching.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Rebuild a degraded AI image to remove crunchy textures and repeated-edit artifacts while preserving identity, style, and composition. Use for clean remakes, not ordinary retouching or upscaling.

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

セミナー・講義・ウェビナー・研修・実演動画をローカルで文字起こしし、内容を分析して、必要なスライド画像や動画クリップ付きのHTML/Markdown資料を作る。動画から学習資料・実践ガイドを作りたい場合に使う。映像作品の再現設計やCanvas生成は対象外。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

責務・依存方向・状態や副作用の境界を監査し、既存挙動を保って段階的にリファクタリングする。read-only監査にも対応する。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

AGENTS.mdや既存スキルをGPT-6 Astra向けに監査・整理するときに使う。契約と意図的な他モデル委譲を保ち、重複、過剰な手順、曖昧な停止条件を修正する。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

人物の参照写真から、同一性を保った複数アングルのキャラクターシートを生成・修正する。指定された身だしなみや撮影表現も整える。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。

The English summary is being prepared. Showing the original description.

ryryo/dot-claude-dev3Updated Oct 18, 2026

See all skills by ryryo

Report a problem with this skill