.md
Skill.mdサーチャーJP
Skill.md一覧に戻る
T
v1.0.0

根本原因を特定してからコードを修正できる

by tettuan

0
194
2026-02-16

説明

できること

  • 症状駆動の修正を防止:「ここにX を追加」という反射的な修正の前に、「なぜXが生成されるのか」という根本原因を問い、設計から逆算します。
  • 設計ドキュメント・スキーマから動作を理解docs/や各種ドキュメント、データベーススキーマから意図された動作を確認し、エラー箇所と原因箇所の乖離を特定します。
  • フロー追跡で問題の発生地点を可視化:トリガー→期待状態→乖離点を図解(Mermaid図)で構造化し、複雑な問題を整理します。
  • 最小限の修正を実装:根本原因に対してのみ変更するため、副作用のない、保守性の高い修正ができます。
  • 修正前の調査結果を記録:複雑な問題はtmp/investigation/<issue>/に overview.md、trace.md、root-cause.mdとして調査結果を保存し、チーム内で知見を共有できます。

こんな人におすすめ

  • バグ修正を担当する開発者:修正前に根本原因を特定し、同じバグの再発を防ぎたい人
  • コードレビュアー:修正が症状対症療法になっていないか、判断したい人
  • チーム全体:バグ調査ノウハウを知見として蓄積・共有したい人
  • レガシーコード保守者:複雑なシステムの問題箇所を素早く特定したい人
SKILL.md の内容
症状駆動の修正を防ぐため、コード変更前に根本原因を特定する。

## 手順

1. **コードを書くな** — まず「なぜこのエラーが起きるか」を問う
2. **設計を読む** — `docs/` やスキーマから意図された動作を理解する
3. **フローを追う** — トリガー → 期待状態 → 乖離点を特定する
4. **根本原因を特定** — エラー箇所と原因箇所は異なることが多い
5. **最小限の修正** — 根本原因に対してのみ変更する

Skill.md 情報

バージョン
v1.0.0
カテゴリ
automation
作成日
2025-03-16

インストール

ワンコマンドで導入
1

下の「Skill.mdをダウンロード」ボタンを押す

2

お使いのAIツール(Claude Code・Cursor・Copilot など)にファイルをアップロードして「このスキルを追加して」と入力する

ターミナルから追加する場合
$ mkdir -p ~/.claude/skills/ && curl -sL "https://github.com/tettuan/breakdownconfig" -o ~/.claude/skills/SKILL.md

関連 Skill.md

注目
K

Flutterアプリを自動ビルド・配布できる

by K9i-0

バージョン番号とビルド番号を自動更新:現在のバージョンを確認し、リリース内容に応じてバージョンを bump(例:1.19.0 → 1.20.0)して pubspec.yaml に反映できます。 更新内容を CHANGELOG に自動反映:前回リリース以降のコミットを自動解析し、Added / Changed / Fixed に分類して CHANGELOG を更新できます。 iOS・Android・macOS の任意の組み合わせで同時リリース:プラットフォームを選択するだけで、複数の OS 向けアプリを同時にビルド・署名・配布できます。 GitHub Actions による自動ビルド・署名・配布:タグ push 後、CI/CD パイプラインが自動実行され、TestFlight・Google Play への配布と GitHub Release 作成までが完全自動化されます。 リリース前の自動検証:静的解析とユニットテストをローカルで実行し、問題がある場合はリリースを防止できます。 Flutter アプリの開発・運用チーム:バージョン管理と配布プロセスを統一・自動化したい組織 複数プラットフォーム対応アプリの担当者:iOS と Android を同時リリースする際の手作業を削減したい リリース頻度が高いプロジェクト:毎週・毎日リリースする際の人的ミスを防ぎたい CI/CD パイプラインを構築したい組織:手動ビルド・配布から自動化へ移行したい Flutter アプリのリリースワークフロー全体を自動化します。前提として main ブランチで作業中で未コミット変更がないことが必要です。主な流れは:(1)現在のバージョン確認と差分コミット収集(grep で pubspec.yaml から version を取得、git log で前回タグ以降の差分を確認)→ (2)バージョンとプラットフォームをユーザーに確認(feat/fix コミット有無により minor/patch を推奨、build number は +1)→ (3)CHANGELOG.md を Added/Changed/Fixed で分類更新 → (4)pubspec.yaml の version 更新 → (5)dart analyze と flutter test による検証(失敗時は進まない)→ (6)git add/commit/push と複数プラットフォーム向けタグ打ち(ios/vX.Y.Z+N、android/vX.Y.Z+N、macos/vX.Y.Z+N)→ (7)GH Actions 自動実行(ios-release.yml で TestFlight・GitHub Release、android-release.yml で Google Play)。バージョン形式は X.Y.Z+N(N はビルド番号)です。

テストコミット
5817.2k2026-04-12
K

Bridge Server を npm に自動リリースできる

by K9i-0

コマンドラインから Bridge Server(@ccpocket/bridge)のバージョン bump・CHANGELOG 更新・タグ push を一元管理でき、その後 GitHub Actions が自動で npm publish と GitHub Release を作成します。 前回のリリースタグからの差分コミットを自動解析し、semantic versioning(major / minor / patch)の推奨版を提示してくれるため、バージョン決定の判断が簡単になります。 CHANGELOG を自動で構造化(Added / Changed / Fixed セクション)し、リリースノートの品質を保ちながら手作業を最小化できます。 ローカルで テスト・型チェック・ビルド を実行して検証してから push するため、リリース後の問題を事前に防げます。 Flutter アプリ側の expectedBridgeVersion を同時に更新できるため、Bridge と アプリのバージョンズレによるバナー表示ミスを防げます。 Bridge Server の保守・リリース担当者またはメンテナー バージョン管理・CHANGELOG 更新・リリース自動化を統一したいプロジェクトチーム npm パッケージの semantic versioning を厳密に運用したい組織 GitHub Actions を使った CI/CD パイプラインを構築・運用する開発者 前提: main ブランチで作業中、未コミット変更がないこと。 手順: 1. バージョン確認・差分収集: package.json の現在バージョンを確認し、前回タグからの差分コミット一覧を取得(git log + 条件指定)。 2. バージョン決定: 差分コミットを分析(feat = minor 推奨、fix のみ = patch、破壊的変更 = major)し、AskUserQuestion でユーザーに具体的なバージョン番号を提示・確認。 3. CHANGELOG 更新: packages/bridge/CHANGELOG.md の先頭に新セクション(Added / Changed / Fixed)を追加。 4. バージョン bump: packages/bridge/package.json を更新。 4.5. Flutter 同期: apps/mobile/lib/constants/app_constants.dart の expectedBridgeVersion を同じバージョンに更新(アプリの古いバージョン検出ロジック対応)。 5. ローカル検証: npm run test:bridge / npx tsc --noEmit / npm run bridge:build をすべて実行し pass を確認(失敗時はユーザーに報告・修正待ち)。 6. コミット・タグ: git add → git commit → git push origin main → git tag bridge/vX.Y.Z → git push origin bridge/vX.Y.Z。 7. 完了確認: GitHub Actions (bridge-release.yml) の自動実行を確認。テスト・ビルド・npm publish・GitHub Release 作成が完了したら終了。

テストコミット
5817.1k2026-04-12
K

Flutter新バージョンへの更新をステップバイステップで実行

by K9i-0

新しくリリースされたFlutterバージョンのBreaking Changes・非推奨APIを自動調査し、プロジェクトへの影響を可視化できます。 コードベース内の非推奨API使用箇所を自動検索し、修正が必要なファイルと行数を特定できます。 mise・GitHub Actions・Shorebird・dependency_overridesなどプロジェクト固有の構成それぞれについて、アップグレード時の対応内容をチェックリスト化できます。 Dart SDK制約やパッケージ互換性を確認し、アップグレード実行時の予期しないエラーを未然に防げます。 リリースノート調査から対応タスク作成まで一貫して進め、アップグレード作業の見落としをなくせます。 モバイルアプリ開発チームの技術リード(Flutter定期更新の計画・実行) Flutterエンジニア(新バージョンリリース時の個別対応確認) DevOps・インフラ担当者(mise・CI/CD・Shorebird等の統合管理) プロジェクトマネージャー(アップグレード作業のスケジューリング・見積もり判断) Flutterアップグレードは3フェーズで進みます。フェーズ1(情報収集): リリースノート(GitHub Issues、docs.flutter.dev、Breaking Changes、Blogから調査)とプロジェクト現状確認(flutter --version、.mise.toml、pubspec.yaml環境)。hotfixの場合はメジャーリリースの Breaking Changes も併せて調査。フェーズ2(影響分析): Breaking Changes について Grep でコードベース内の使用箇所を検索。mise・GitHub Actions・Shorebird・dependency_overrides・パッケージ互換性(flutter pub outdated)・Dart SDK制約を個別確認。フェーズ3(対応タスクリスト作成): 必須タスク(.mise.toml更新、mise install、各ワークフロー確認等)と修正対応(Breaking Changes修正、Shorebird doctor確認等)を整理。各フェーズで WebSearch/WebFetch でアップグレード最新情報を参照します。

テストドキュメント記事
5817.2k2026-04-12