Communitygithub.com

AlemTuzlak/skills

バグ修正用スキル:テスト失敗、CI エラー、API の誤った結果、スタックトレース表示、またはユーザーが「壊れている」「直して」と言った場合に使用します。失敗を伴わない新機能や、型のみの作業、ドキュメントには使用しないでください。

skills とは?

このスキルは、ソフトウェアのバグ修正プロセスを厳密にガイドするために設計されています。アプリケーションやライブラリの区別なく、根本原因を特定し、症状を一時的にごまかすのではなく根本から修正することを重視します。対応が必要なのはテスト失敗、CI エラー、API の誤った応答、スタックトレース、ユーザーからの明示的なバグ報告など、明らかに障害が存在する場合のみです。このスキルは、ログの段階的な追加と削除、仮説立案と検証、失敗テストの作成と修正、そして最後にオプションの証明手順という一連の厳格な手順を定義しています。「推測で修正する」ことや「問題を隠すための回避策」を厳しく禁止し、ログが残ったままの修正や失敗テストの削除などを警告するレッドフラグ表も提供します。Claude Code や Cursor などの AI エージェント上で動作し、エージェントが自律的にバグ修正を安全かつ確実に行うためのフレームワークとして機能します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/fix-bug

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

バグを修正する

根本原因を見つけなさい。症状を一時的にごまかしてはいけません。アプリケーションかライブラリかは問いません。

このスキルは、修正がグリーンになった後で、かつユーザーがそれを選択したか、すでに証明を依頼している場合にのみ prove-it を読み込みます。CopilotKit のデバッグスキルを上書きしません。

使用するタイミング

障害が発生している場合に読み込んでください:テスト失敗、赤い CI、予期しない結果、スタックトレース、またはユーザーが「壊れている」「直して」と言った場合。

失敗を伴わないグリーンフィールド機能はスキップしてください。ドキュメントや型のみの編集もスキップします。

厳格なゲート

  1. ログから原因が特定されるまで修正しないでください。 「いくつか試してみる」は禁止です。
  2. ホットパス上に 少なくとも3つの仮説を立ててください。それぞれ異なる場所(自関数、呼び出し元、依存関係)からです。
  3. 仮説を置いたすべてのパスの前後にデバッグログを追加してください。サードパーティパッケージにデバッグモードがある場合は、この調査のためにオンにしてください。
  4. 原因を特定したら、このスキルが追加したすべてのログを削除し、サードパーティのデバッグをオフにしてください。 その後、失敗するテストを書き、修正してください。ログは修正に残してはいけません。
  5. グリーンにするために失敗テストをスキップ、削除、無効化しないでください。エラーを飲み込まないでください(|| true、空の catch)。レースコンディションを隠すためにタイムアウトを長くしないでください。
  6. 根本原因を修正し、さらにそのファイル/近傍モジュールにある同じパターンも修正してください。余分なリファクタリングは禁止です。
  7. ユーザーが選択するか、すでにこの修正の証明を依頼していない限り、prove-it を読み込まないでください。 テストスイートがグリーンであることは証明ではありません。デフォルトはスキップです。

ホットパス

失敗するテスト(またはユーザーの操作)からエラー行までのスタックをたどり、さらにそこで呼び出される関数と呼び出す関数も含みます。

そこから始めてください。排除していく。 絞り込む。そのパス上のすべての仮説が否定された場合のみ範囲を広げてください。

手順

手順 1: 読む

  1. エラー、スタックトレース、CI ログの全文を読んでください。すべての行を。
  2. 失敗テストがある場合は、その本文を読んでください。
  3. そのバグを導入したと思われる差分があれば、それを読んでください。
  4. まだ編集しないでください。

手順 2: 仮説

  1. ホットパス(ファイルと関数)をマッピングしてください。
  2. 少なくとも3つの仮説を書いてください:「エラーは X が原因で、なぜなら Y だから。」それらはホットパス全体にわたっていなければなりません(同じ行に対する3つの推測ではありません)。
  3. 3つ書けない場合は、十分に読んでいないということです。手順 1 に戻ってください。

手順 3: 計測

  1. 仮説に登場するサードパーティパッケージごとに、そのドキュメントでデバッグフラグや環境変数を確認してください。存在すればオンにします。
  2. 仮説を置いた各ブランチの前後に一時的なログを追加してください(入力、出力)。リポジトリの既存のロガーか console を使用してください。ロギングパッケージを追加しないでください。
  3. 一度再現してください。ログを読んでください。ログによって否定された仮説に**×をつけて**ください。
  4. すべての仮説が否定された場合、ホットパスを1ステップ広げてください(次の呼び出し元か次の依存関係)。新しい仮説、新しいログ。再度排除してください。
  5. 原因が特定されたら:このスキルが追加したすべてのログを削除してください。 サードパーティのデバッグをオフにしてください。ワーキングツリーにそれらのログが残っていないことを確認してください。

手順 4: 失敗テスト、次に修正

  1. このバグが原因で失敗するテストを書いてください(赤)。独立した期待値を使用してください。このステップをスキップしないでください。
  2. 実行してください。指定した理由で失敗しなければなりません。
  3. 根本原因のみを修正してください。また、そのファイル/近傍モジュールで同じ間違いのコピーがあれば修正してください。
  4. そのテストを実行してください(グリーン)。次に、このパッケージ/ファイルのスイートの既存のテストを実行してください。
  5. 新しい失敗が発生した場合、それを新しいバグとして扱ってください。手順 1 からやり直してください。新しい破損の上に最初の修正を出荷しないでください。

手順 5: オプションの証明 (prove-it)

  1. このパッケージのスイートがグリーンになり、ログがなくなったら、1回だけ尋ねてください。 選択肢:prove-it を読み込む、またはスキップ。デフォルトはスキップです。
  2. 待ってください。ユーザーが選択するまで prove-it を読み込まないでください。
  3. ユーザーがこの会話の中で既にこの修正の証明を依頼している場合は、尋ねるのをスキップしてください。prove-it を読み込んでください。
  4. スキップの場合: 修正はユーザーパスとして証明されていないと伝えてください。グリーンスイートを証明として扱わないでください。手順 6 へ。
  5. ユーザーが prove-it を選択した場合:prove-it を読み込んでそれに従ってください。その後、手順 6 へ。
  6. このスキル内でアプリをクリックしたり、API に curl したり、証明レポートを書いたりしないでください。その作業は prove-it の担当です。

手順 6: 停止

スキップ後、または prove-it が戻ったら、停止してください。

決定木

  • 障害が発生中 → 手順 1 → 2 → 3 → 4 → 5 → 6。
  • 再現不可 → 停止。「再現できません」と伝え、手順を尋ねてください。推測で修正しないでください。
  • ログがすべてのホットパス仮説を否定 → 範囲を広げ、手順 2 からやり直し。
  • 修正後もテストが赤のまま → 原因が間違っています。修正を元に戻し、手順 2 に戻ってください。
  • 次の関数に同じパターンがある → この同じ変更で修正してください(厳格なゲート 6)。
  • スイートはグリーン、まだ証明の依頼なし → 手順 5(尋ねる、デフォルトスキップ)。
  • ユーザーが既にこの修正の証明を依頼している → prove-it を読み込み、その後手順 6。

レッドフラグ

シグナル意味代わりに行うこと
仮説1つでパッチ推測手順 2。ホットパス上で3つ。
ログなしの修正排除なし手順 3。
差分にデバッグ console.log が残っているログ未削除手順 3 のステップ 5。その後テスト。
サードパーティの DEBUG=* がオンになったままハントフラグが出荷されたログと一緒にオフにする。
.skip / 失敗テストの削除症状のごまかしコードを修正する。
|| true / 空の catchエラーを飲み込む原因を説明するか修正する。
より長いタイムアウト隠されたレースコンディションレースコンディションを修正する。
修正中のリファクタリングついで根本原因 + 同じパターンのみ。
モノレポ全体のテスト実行依頼なしこのパッケージ / このスイートのみ。
「自分のマシンでは動く」異なる環境失敗と同じコマンド / 同じ条件で。
依頼なしで prove-it を読み込む依頼されていない証明手順 5。デフォルトスキップ。
このスキル内でのミニブラウザ通過prove-it の重複ユーザーが選択した後に prove-it を読み込む。
「テストが通ったので証明された」グリーンスイートを証明として扱う手順 5。スキップは証明されていないことを意味する。

エラーハンドリング

  • 再現不可: その旨を伝えてください。実行した内容をリストアップしてください。修正をでっち上げないでください。
  • 依存関係にデバッグモードがない: そのステップはスキップしてください。それでもホットパス上の自コードにはログを残してください。
  • ログが膨大: ファイルのすべての行ではなく、仮説を置いたブランチのみにログを追加してください。
  • 失敗テストがまだ書けない(テストハーネスがない): バグをアサートする1ファイルのスクリプトを代用として使用してください。それでも赤、次に修正、そしてグリーン。
  • 修正によって別のテストが失敗する: その失敗に対して手順 1 を実行してください。カスケードが解決されるまで最初の修正をプッシュしないでください。
  • prove-it がこのエージェントにない: その旨を伝えてください。スキップを提案してください。ここで2つ目の証明手順をでっち上げないでください。
  • ユーザーが prove-it を選んだ後、その中でスキップした: 修正は証明されていません。手順 6。

このスキルはヘルパーを配置したりドキュメントを書いたりしません。証明は手順 5 のみです。

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

関連スキル