/note/tech

日々の開発で使っているClaude Code Skills

要約:

■ 1. 記事概要

  • 著者: inari111(RemitAid所属ソフトウェアエンジニア)
  • 公開日: 2026年5月22日
  • RemitAid Tech Blogにおいて、Claude Codeを活用した開発ワークフローで運用中のスキル群を紹介する内容

■ 2. 既存スキルの活用

  • superpowers(github.com/obra/superpowers):
    • brainstorming・subagent-driven-development・executing-plansの3スキルを利用
    • brainstormingにより設計書をマークダウン形式で出力
    • 計画に沿った実装により30〜40分の連続自律動作が可能
    • 推奨ワークフロー(brainstorming → using-git-worktrees → writing-plans → test-driven-development)が存在する
  • dig & decomposition(github.com/fumiya-kume/claude-code):
    • dig: AskUserQuestionToolを使用して再帰的に質問を重ね、要件の検討漏れを防止
    • decomposition: 計画後のタスク分割を行い、自動的な連続実行を実現
  • drawio(github.com/jgraph/drawio-mcp/tree/main/skill-cli):
    • Goアプリケーションのアーキテクチャ図を生成
    • 手動作成より容易に出力でき、コードと画像をGitで一括管理

■ 3. 自作スキル

  • feature-dev:
    • Boris Taneの「How I Use Claude Code」ブログをSkill化したもの
    • リサーチ・計画・実装の3フェーズ構成:
      • リサーチ: research.mdに調査内容を書き出し、人間が検証する
      • 計画: plan.mdにプランを出力し、インライン注釈による反復改善を行う
      • 実装: plan.mdのTODOチェックリストを順序通りに実行
    • インライン注釈の形式:
      • <!-- NOTE: コメント -->: 補足・提案
      • <!-- REJECT: 理由 -->: 却下
      • <!-- QUESTION: 質問 -->: 確認事項
  • codex:
    • 公式スキル不在時にMCP連携をSkill化した自作スキル
    • 現在は公式版(openai/codex-plugin-cc)と併用
    • /codex 差分をレビューしてください の形式で実装後レビューを依頼
  • commit-message:
    • git addされたファイルを対象にコミットメッセージを生成
    • コミット粒度の判断およびfixup可能性の検討も実施

■ 4. 計画ファイルの管理方法

  • ディレクトリ構成例:
    • plans/
      • product A/
        • 001_hoge/plan.md
        • 002_fuga/research.md、plan.md
      • product B/
        • 001_xxx/plan.md
  • k1LoW/moツールを使用してブラウザ上で計画ファイルを閲覧・管理

■ 5. 著者の方針・推奨事項

  • リサーチと計画の洗練に時間をかけ、Claudeは計画に従って実装するだけの状態にすることが重要
  • 「Once the plan is right, execution should be straightforward.」という考え方を基本とする
  • 複数Claude Codeを並行起動する際の焦りへの注意を喚起
  • リサーチ・計画の丁寧さがアウトプット品質に直結することを強調