Communityライティング&編集github.com

Arzaroth/skills

チケットの技術的な事後分析(ポストモーテム)記述を作成します。根本原因と修正内容を1つのトラッカーフィールドにまとめ、他の分析フィールドからそのフィールドを参照させます(「dev notes参照」)。トラッカー、フィールド、言語、見出しは設定ファイルから取得します。指定されたチケットまたは現在進行中の修正内容に対して呼び出します。トリガーは「analyse des causes」「analyse technique」「root cause」「cause racine」「solution apportée」「/analyse-causes」です。

skills とは?

このスキルは、チケットの技術的な事後分析(ポストモーテム)を自動生成するためのものです。根本原因(Root cause)と修正内容(Fix)を1つのフィールドにまとめ、他の分析フィールドからそのフィールドを参照させることで、同じ情報を二度記述する手間を省きます。設定ファイル (`~/.config/skills/analyse-causes/config.md`) で、トラッカー、プロジェクトとチケットのキーパターン、フィールドフォーマット、記述言語、見出し、記述フィールド、参照フィールド、MRリンクフィールドを定義します。Claude Code、Cursor、CodexなどのAIエージェントで動作し、チケット番号を引数として渡すか、セッション内で現在進行中の修正(diff/branch/MR)を自動検出して処理します。出力は設定された言語でマークダウン形式で生成され、初期症状を再記述せず、コードレベルの真の根本原因と具体的な修正内容のみを簡潔に箇条書きで記述します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Arzaroth/skills/tree/HEAD/skills/analyse-causes

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

チケット技術事後分析(1フィールド+参照方式)

ユーザーはすべてを1つのフィールドにまとめ、他の分析フィールドからそのフィールドを参照させます。これにより同じことを二度記述する必要がありません。このワークフローを再現してください。

設定

~/.config/skills/analyse-causes/config.md を最初に読んでください。このファイルには、トラッカーとそのツール、プロジェクトとチケットのキーパターン、フィールドフォーマット、記述言語と見出し、記述フィールド、参照先のテキストを含む参照フィールド、MRリンクフィールドが設定されています。設定ファイルがない場合は、config.example.md(このファイルの隣)を ~/.config/skills/analyse-causes/config.md にコピーして内容を記入するようユーザーに伝え、処理を停止してください。

ターゲット: 引数として渡されたチケット。それ以外の場合は、セッション内で進行中の修正(diff/branch/MR)を対象とします。

生成内容

1つの完全な記述文書を、設定された言語でマークダウン形式で作成します。設定された見出しの下に2つのセクションを含めます:

  1. 根本原因 - 技術的なWHY。初期状況(症状/チケットの説明)を再記述しないでください。真の起源に遡ってください: 設計上の選択、constant/file:line、誤った前提。目に見える症状は絶対に含めないでください。
  2. 修正 - 何が変更され、なぜそれが根本原因を取り除くのか。事実に基づいて: 選択されたメカニズム、触れたファイル/定数、結果としての動作。ここにMRリンクは含めないでください: MRリンクは設定されたMRリンクフィールドに記述します。

ルール: 簡潔、短い箇条書き、正確な用語(constants、functions、file:line)、実際のコードと照合すること。emダッシュ(U+2014)は使用しないでください。代わりにハイフン、カンマ、または言い換えてください。

手順

  1. チケットを特定する: 引数が設定されたパターンに一致するキーの場合はそのチケット、そうでない場合は進行中の修正(セッションのdiff/branch/MR)を対象とする。
  2. 必要に応じて設定されたツールでチケットを読むが、その説明をコピーしない。
  3. コード内で根本原因を追跡し、修正の変更点(git diff/MR)をリストアップする。
  4. 完全な記述文書を作成する。
  5. それを表示し、設定されたフォーマットでフィールドに書き込む:
    • 記述フィールド <- 完全な記述文書
    • 各参照フィールド <- 設定された参照テキストを含む1段落のドキュメント チケットがターゲットでない場合(キーのないセッション内の修正のみ)は、記述文書のみを表示し、フィールドへの書き込みを提案する。

Individual skills in this repo

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

Arzaroth/skills

Work one round of review comments on a pull/merge request: fetch every unresolved thread, verify each finding against the current code, fix what is still valid, reply with a justification to what is not, then commit, push and answer every thread. Use when a PR has review comments to deal with - from an AI reviewer (CodeRabbit and friends) or a human - and when asked to 'address the review', 'fix the review comments', 'respond to CodeRabbit', or 'handle the PR feedback'. The babysit-pr skill calls this for each of its rounds.

Arzaroth/skills

Open a pull/merge request and stay with it until it merges: trigger the reviewers, watch for their verdict, work each round of findings, push, re-trigger, and merge when it is clean. Handles AI reviewers (CodeRabbit) and human maintainers, on GitHub (gh) and GitLab (glab). Use when asked to 'open a PR and babysit it', 'ship this and see it through', 'get this PR merged', 'watch the PR until it lands', or '/babysit-pr'. Also the review-and-merge half of ship-feature-pipeline.

Arzaroth/skills

Check whether the repo's own docs still describe the code after recent changes, and update the ones that went stale. Scopes itself to the last merged branch, the last commit, this session's work, or a full sweep. Use when asked to 'update the docs', 'check the docs', 'are the docs still accurate', 'docs sweep', 'refresh the documentation', or '/docs-update'. Every line it writes goes through the unslop skill. Run it before cutting a release or merging a feature, so docs ship with the change instead of trailing it.

Arzaroth/skills

Cut a release on GitHub: update the changelog, bump the version (preferring the repo's own release task or script over a manual edit), tag, push, then watch the release workflow until the GitHub Release exists. Use when asked to 'cut a release', 'release version X', 'ship a new version', 'bump the version and tag', 'publish a release', or '/gh-release'. For repos where a tag push triggers a GitHub Actions workflow that creates the release.

関連スキル