Claude-skill-registry implement

指定されたGitHub Issueをworktree環境で実装する完全ワークフロー。Subtask検出からPRマージまでを統括。

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/implement" ~/.claude/skills/majiayu000-claude-skill-registry-implement-642ec9 && rm -rf "$T"
manifest: skills/data/implement/SKILL.md
source content

Issue実装ワークフロー (/implement)

役割: Sisyphus (Main Agent) が実行する実装のメインループ 環境: Host環境 + Git Worktree


🔄 全体フロー

  1. Issue分析 & 準備

    • 粒度チェック (200行以下?)
    • Subtask検出 (親Issueの場合 → 再帰的に実行)
    • 既存実装の確認
  2. 環境構築 (Phase 1)

    • /create-worktree
      で独立環境を作成
    • 作業ディレクトリへ移動 (
      cd .worktrees/issue-XXX
      )
  3. 実装サイクル (Phase 2-3)

    • TDDサイクル: Red → Green → Refactor
    • 品質保証: Lint, Test, 品質レビュー (9点以上)
    • 客観的基準:
      quality-review-flow
      準拠
  4. PR作成 (Phase 4)

    • ユーザー承認
    • /pr-and-cleanup
      でPR作成と環境削除
  5. CI監視 & 自動マージ (Phase 5)承認不要・自動実行

    • pr-merge-full.sh
      で一括実行
    • CI完了待機 → 成功で即マージ
    • CI失敗時は自動修正(最大3回)
    • 3回失敗でエスカレーション

📋 Sisyphus 実行ガイド

1. 準備フェーズ

まず、Issueのサイズと依存関係を確認します。

  • 粒度チェック: 200行を超える場合は
    /decompose-issue
    を提案
  • Subtask検出: 親Issueの場合は
    /decompose-issue
    を実行し、各Subtaskに対してこのワークフローを適用
  • 作業開始:
    /create-worktree <issue_id> <branch_name>
    

2. 実装フェーズ

重要: すべてのファイル操作・コマンド実行は Worktreeディレクトリ内 で行います。

# 必ず移動してから作業
cd .worktrees/issue-<id>-<name>

TDDの実践

  1. Red: テストケースを作成(
    write
    tool)
  2. Green: テストを通す最小限の実装(
    write
    /
    edit
    tool)
  3. Refactor: コードを整理

3. 品質レビューフェーズ

PR作成前に必ず品質チェックを行います。

  1. 自己チェック:
    # プロジェクトに応じたコマンド
    npm run lint && npm test
    # または
    cargo clippy && cargo test
    
  2. 専門レビュアーによるレビュー:
    • quality-review-flow
      skill を参照
    • 9点未満の場合は修正して再レビュー

4. PR作成フェーズ

  1. 承認ゲート: ユーザーにPR作成の許可を得る
  2. PR作成と環境削除:
    /pr-and-cleanup <issue_id>
    

5. CI監視&自動マージフェーズ

PR作成後、承認なしで自動的にCI監視→マージまで実行します。

一括実行コマンド(推奨)

bash .pi/skills/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number>

このスクリプトが以下を自動実行します:

  1. CI完了待機(最大10分)
  2. CI成功 → 自動マージ(
    --merge --delete-branch
  3. Issueラベル更新(
    env:merged

CI失敗時の自動対応

CI失敗時は

ci-workflow
に従い自動修正を試みます:

失敗種別自動対応
Lint/Format
--fix
で自動修正 → push → 再待機
Test/Buildコード修正 → push → 再待機
3回失敗PRをDraft化してユーザーにエスカレーション
# CI失敗時の手動対応が必要な場合
gh run view --log-failed  # ログ確認
# 修正後
git add . && git commit -m "fix: CI修正" && git push
# 再度マージ試行
bash .pi/skills/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number>

詳細:

ci-workflow
skill および
pr-merge-workflow
skill を参照


⛔ 禁止事項

  1. メインブランチでの直接作業: 必ずWorktreeを作成すること
  2. テストなしの実装: TDDを原則とする
  3. レビューなしのPR作成: 必ず品質レビューを通すこと
  4. Worktree外のファイル操作: 誤ってルートディレクトリのファイルを書き換えないこと