Agent skill

task-run

[タスク] 3. Issue実行 + 進捗同期

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/task-run

SKILL.md

[タスク] 3. Issue実行 + 進捗同期

入力: $ARGUMENTS

  • Issue番号（例: #123 または 123）
  • 省略時: 実行可能なIssue（依存解決済み）を一覧表示して選択

🎯 目的

  • 指定されたIssue（または選択したIssue）に従って実装を行う
  • 組み込みTask と GitHub Issue の進捗を同期する
  • 完了時に両方を更新（Task: completed、Issue: close）

共通前提（参照）

  • 実装規約・口調・TDD・Docコメント等は CLAUDE.md に従う
  • doc/input/rdd.md を読み、該当する .claude/skills/* を適用
  • 詳細運用は doc/guide/ai_guidelines.md を参照

実行手順

1. Issue選択（引数省略時）

📋 実行可能なIssue（依存解決済み）

┌────┬─────────────────────┬──────────┬─────────────┬─────────────┐
│ #  │ Title               │ Issue    │ Task Status │ blockedBy   │
├────┼─────────────────────┼──────────┼─────────────┼─────────────┤
│ 1  │ API設計             │ #126     │ pending     │ なし ✅     │
│ 2  │ ユーザー認証実装     │ #123     │ pending     │ なし ✅     │
│ -  │ ログイン画面作成     │ #124     │ pending     │ #123 ⏳     │
└────┴─────────────────────┴──────────┴─────────────┴─────────────┘

→ どのIssueを実行する？ [番号を入力]

2. プレチェック

bash
# Issue内容を取得して確認
gh issue view {ISSUE_NUMBER}
  • ready-for-dev ラベルがあるか
  • RDD参照セクションの存在
  • 変更要求がある場合は 承認済み か確認
  • 組み込みTaskの blockedBy が空か確認

2.5. 作業ブランチ作成（通常 or worktree）

通常モード（単一タスク）:

bash
git checkout -b task/{ISSUE_NUMBER}-{short-description}

並行モード（git worktree）: 複数タスクを同時に進める場合は worktree を使用:

bash
# 親ディレクトリにworktreeを作成
git worktree add ../$(basename $(pwd))-task-{ISSUE_NUMBER} -b task/{ISSUE_NUMBER}-{short-description}

# worktreeに移動して作業
cd ../$(basename $(pwd))-task-{ISSUE_NUMBER}

Tips: 別ターミナルで別のClaude Codeセッションを起動し、異なるworktreeで並行作業が可能。 完了後は git worktree remove ../project-task-{ISSUE_NUMBER} で削除。

3. 着手（組み込みTask + Issue同期）

組み込みTask更新:

TaskUpdate:
  taskId: "{task-id}"  # metadata.issueNumber で特定
  status: "in_progress"

Issueコメント（⚠️ 確認あり）:

bash
gh issue comment {ISSUE_NUMBER} --body "🚀 着手開始

## 実行計画
- [ ] {ステップ1}
- [ ] {ステップ2}
- [ ] {ステップ3}
"

4. 実装（TDD厳守）

  • CLAUDE.md の規約に従い、RED → GREEN → REFACTOR で段階的に進める
  • 要件をToDoに分解（最小ステップ）
  • 既存パターン再利用と重複回避を最優先

5. 検証

bash
pnpm lint --fix && pnpm type-check
pnpm test
  • 失敗時の切り分け（最小サンプル運用等）は CLAUDE.md の方針に従う

UI変更がある場合（Agent Browser利用可能時）:

bash
# 開発サーバーを起動後、Agent Browserでページを確認
agent-browser open http://localhost:3000/{対象パス}
agent-browser snapshot -i  # 要素一覧を取得
# 必要に応じてインタラクション確認
agent-browser click @{ref}
agent-browser fill @{ref} "テスト入力"
  • 表示崩れ、状態遷移、レスポンシブを目視確認
  • 問題発見時は修正後に再スナップショット

6. 進捗報告（適宜）

bash
gh issue comment {ISSUE_NUMBER} --body "📝 進捗報告

## 完了
- [x] {完了したステップ}

## 次のステップ
- [ ] {残りのステップ}

## メモ
{気づいた点や注意点}
"

7. コミット + PR作成

コミット（⚠️ 確認あり）:

bash
git add -A
git commit -m "feat: {変更概要} (#${ISSUE_NUMBER})

- {主要変更1}
- {主要変更2}

Refs #${ISSUE_NUMBER}"

リモートにプッシュ:

bash
git push -u origin task/{ISSUE_NUMBER}-{short-description}

PR作成（⚠️ 確認あり）:

bash
gh pr create \
  --title "feat: {変更概要}" \
  --body "## 概要
{このPRで何を実現するか}

## 変更内容
- {主要変更1}
- {主要変更2}

## RDD整合
- **準拠**: OK（根拠: doc/input/rdd.md §...）
- **変更要求**: 無し / 有（承認済み）

## 検証結果
- [x] lint/type-check PASS
- [x] test PASS

## テスト手順
1. {確認手順1}
2. {確認手順2}

Closes #${ISSUE_NUMBER}" \
  --base main

Note: Closes #${ISSUE_NUMBER} により、PRマージ時にIssueが自動closeされるにゃ。

8. 完了（組み込みTask更新）

組み込みTask更新:

TaskUpdate:
  taskId: "{task-id}"
  status: "completed"

完了報告:

✅ TASK-{ISSUE_NUMBER} 完了

- PR: #{PR_NUMBER}
- マージ後に Issue #{ISSUE_NUMBER} が自動close

失敗時のガイド

RDD違反

bash
gh issue comment {ISSUE_NUMBER} --body "⚠️ RDD違反検出

## 内容
{違反内容}

## 変更要求(ADR-lite)
{変更提案}

## ステータス
承認待ち（ユーザー確認後に再開）
"

制約で実現不能

bash
gh issue comment {ISSUE_NUMBER} --body "🚫 実現不能

## 理由
{制約の内容}

## 代替案
1. {代替案1}: {影響}
2. {代替案2}: {影響}

## ロールバック方法
{戻し方}
"

品質チェックリスト

  • RDD準拠（スタック/制約に一致）
  • Docコメント（JSDoc/Docstring）が全関数・クラスにある
  • 重複コードを作らず既存パターンを再利用
  • コメントでドメイン意図と決定理由を明記
  • 検証ゲート（lint/type/test）がPASS
  • 必要なら最小サンプルで検証済み（削除可注記）
  • 技術的負債が記録され、次スプリントに回されている
  • コミットメッセージに Issue番号を含めている
  • PRを作成し、Closes #Issue番号 を本文に含めている
  • 組み込みTask が completed に更新済み

自己評価

  • 成功自信度: (1-10)
  • 一言理由: {短く理由を記載}

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results