Community寫作與編輯github.com

Arzaroth/skills

填寫工單的技術事後分析——將根本原因與修正內容寫入一個追蹤欄位(不重複描述初始症狀),然後將其他分析欄位指向該欄位(「請參閱開發者筆記」)。追蹤系統、欄位、語言與標題均來自設定。可針對指定工單或正在進行中的修正執行。觸發詞:「analyse des causes」、「analyse technique」、「root cause」、「cause racine」、「solution apportée」、「/analyse-causes」。

skills 是什麼?

這項技能專為開發者與專案經理設計,用於自動化撰寫工單的技術事後分析(post-mortem)。其核心概念是將所有分析內容集中在一個欄位中,其他欄位則以簡短的指標文字(如「請參閱開發者筆記」)指向該欄位,避免重複描述。技能會依據使用者設定的 `~/.config/skills/analyse-causes/config.md` 配置檔決定使用的問題追蹤工具、專案與工單鍵值規則、欄位格式、撰寫語言、標題、主要分析欄位、被指向的欄位及其指標文字,以及合併請求(MR)連結欄位。支援的觸發詞包括「root cause」、「analyse technique」等,可指定工單編號或自動偵測當前會話中的差異(diff)/分支/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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

工單技術事後分析(一個欄位 + 指標)

使用者將所有內容放在一個欄位中,並將其他分析欄位指向該欄位,這樣就不需要重複說明。請重現該工作流程。

設定

在處理任何其他事項之前,請先讀取 ~/.config/skills/analyse-causes/config.md。該檔案會設定追蹤系統及其工具、專案與工單鍵值模式、欄位格式、撰寫語言與標題、撰寫欄位、被指向的欄位及其指標文字,以及 MR 連結欄位。如果缺少該檔案,請告知使用者將 config.example.md(與此檔案相鄰)複製到 ~/.config/skills/analyse-causes/config.md 並填寫內容,然後停止。

目標:使用傳入的工單做為引數,否則使用會話中正在進行中的修正(diff / 分支 / MR)。

應產出的內容

一份完整的分析報告,使用設定的語言,以 Markdown 格式撰寫,並包含兩個章節(使用設定好的標題):

  1. 根本原因 - 技術上的「為什麼」。不要重述初始情況(症狀 / 工單描述)。要追溯到真正的起源:設計選擇、常數 / 檔案:行號、錯誤的假設。絕不能是可見的症狀。
  2. 修正 - 什麼改變了,以及為什麼它能消除根本原因。要基於事實:選擇的機制、觸及的檔案/常數、產生的行為。此處不含 MR 連結:它會被放入設定的 MR 連結欄位。

規則:簡潔、使用簡短要點、使用精確的術語(常數、函式、檔案:行號),並與實際程式碼比對驗證。不要使用長破折號(U+2014)——使用連字符、逗號或重新措辭。

流程

  1. 識別工單:引數 = 符合設定模式的鍵值;否則為正在進行中的修正(會話的 diff / 分支 / MR)。
  2. 如有需要,透過設定的工具讀取工單,但不要複製其描述。
  3. 在程式碼中追溯根本原因,並列出修正的變更內容(git diff / MR)。
  4. 撰寫完整的分析報告。
  5. 顯示報告,然後以設定的格式填寫欄位:
    • 撰寫欄位 <- 完整的分析報告
    • 每個被指向的欄位 <- 一份單段落的文件,內容為設定的指標文字 如果沒有指定目標工單(會話中有正在進行中的修正但沒有對應鍵值),則僅顯示報告並提供填入欄位的選項。

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.

相關技能