Agent Automation & Development Skills

識別與避免 Claude Code agent 下 bash 指令的三層防線:(1) Anti-Pattern 1 過度複雜單行(多行 heredoc、巢狀引號、內嵌 Python -c / Node -e、複雜 if/elif、 for-loop-file-list),(2) Anti-Pattern 2 bash 字串內特殊 Unicode(em dash、 en dash、emoji),(3) Anti-Pattern 3 stateful cd(CWD 污染 / cd-before-git / cd + 2>/dev/null 路徑隱藏)。另含 Rule 14 shell 引號衛生(simpleexpansion / 同型引號衝突 / grep BRE alternation / 反向巢狀 subshell / expansion false positive)與 Rule 15 不可逆操作邊界(alembic migrate / terraform apply / git push --force / rm -rf / kubectl apply)。觸發情境:parser 錯誤「Unhandled node type: string」「Contains simpleexpansion」「Contains expansion」「Newline followed by inside quoted argument」、「bash heredoc 失敗」、「cd 會污染 CWD」、 「stateful cd」、「不可逆操作要不要執行」、「terraform apply 確認」、「git push --force 安全嗎」、agent 自我反省「這段 bash 太複雜」「要不要寫成 script」 「cd 指令要不要改成…

評估任何 repo 的 Claude Code harness 就緒度。11 維度(D1–D11),PASS/WARN/FAIL 健康清單, 優先改善 TODO。涵蓋 CLAUDE.md / hooks / settings / skills / testing-CI / git / rules / security / subagents / codebase-navigation / token-economy。觸發關鍵字:harness eval、 agentic readiness、claude code 健診、評估 repo、harness 評分、改善 TODO、agentic posture、 token economy、context budget、always-on…

單一 PR / session 收尾的 agent-led 回顧:agent 從 PR context(title/body/AC/commits/diff) 自動推論 5 題草稿(problem / value / experience / lessons / improvement), 呈現給使用者校準後寫入 mycelium handover(tags 含 "pr-retrospective" 以便 handover-back 排除), 並依 Lesson Classifier 路由到 .claude/rules/ 子檔(bash/quoting/skill-authoring/irreversible/security) 或 CLAUDE.md(fallback),再觸發 hookify:hookify、/claude-md-management:revise-claude-md、 /claude-code-setup:claude-automation-recommender、superpowers:writing-skills 等下游 skill。 觸發關鍵字:pr 回顧、pr retro、pr retrospective、session 收尾、merge 後檢討、 五個問題回顧、AC 驗收、DoD 完成、what problem we want to solve、 what value we deliver、lessons learned this…

Install a Claude Code PreToolUse hook to prevent direct git push from a worktree branch to origin/main. Applies to all projects using EnterWorktree or git worktree add.

Senior QA test design techniques using structured methods to produce high-quality test cases. Trigger contexts: user mentions "design test cases", "write test cases", "analyze test scope", "review AI-generated cases", "QA test design", "how to test this feature". Applies six core techniques: Equivalence Partitioning, Boundary Value Analysis, Decision Table, State Transition, Pairwise / Combinatorial Testing, and Risk-Based Testing. Produces structured test case tables and coverage analysis. Also triggers when user says "help me think through how to test this", "what should I watch out for in this feature", "testing strategy", "help me review these test cases". Must trigger when user pastes a requirements spec, User Story, AC, or API doc and asks for test scope analysis.

bash-hygiene hook audit log 管理:啟用/停用記錄、查看近期 hook 攔截事件、統計違規比例與熱點 pattern。觸發關鍵字:audit log、hook 記錄、bash-hygiene 統計、啟用 audit、停用 audit、查看 block…

審查並精簡 CLAUDE.md 文件:把累積的 gotcha / 規則段落路由到對應的 .claude/rules/ 子檔, 刪除過期內容,維持 CLAUDE.md 在 Anthropic 建議的 200 行軟上限內。 觸發關鍵字:CLAUDE.md 太大、精簡 CLAUDE.md、CLAUDE.md 太多規則、migrate gotcha to rules、 CLAUDE.md bloat、清理 CLAUDE.md、整理 CLAUDE.md、prune CLAUDE.md、 CLAUDE.md 行數、revise CLAUDE.md、rules…

辨識 AI 生成文字(AI Slop)的分析技術。適用情境:用戶貼上一段文字請你「判斷是不是 AI 寫的」「分析這段文字的 AI 感」「幫我看看這是不是 ChatGPT/Claude/Gemini 產出的」「偵測 AI 內容」「這篇文章讀起來怪怪的」「這個回覆像機器人」等。也適用於用戶想要「改掉 AI 味」「讓文章更像人寫的」「去除 AI 痕跡」「humanize」的場景。當用戶提到 slop、AI detection、AI 偵測、AI 判斷、機器人文字、AI 寫作風格分析時,必須觸發此…

Flutter 行動應用的測試驅動開發(TDD)專家指引。 適用情境:用戶詢問 Flutter 測試、TDD 工作流程、unit/widget/integration test 撰寫、 mock 依賴、BLoC/Riverpod/Clean Architecture 可測試性設計、golden test、 測試覆蓋率、Flutter CI/CD 設定。 觸發關鍵字:「flutter test」、「tdd flutter」、「widget test」、「mockito flutter」、 「bloctest」、「integration test flutter」、「flutter 怎麼測試」、「Flutter 測試策略」、 「flutter unit test」、「flutter golden test」。 當用戶貼上 Flutter 程式碼並詢問如何讓它可測試時,也應觸發此…

針對單一 harness-eval 維度做深度稽核與具體修法。配合 /harness-eval 使用: 先跑全面評估,發現 WARN/FAIL 後用此 skill 精準挖掘。 用法:/harness-eval-focus D2(或 D1~D10)。 觸發關鍵字:harness-eval-focus、深度稽核、維度修法、D2 hook 問題、 D3 權限問題、D1 CLAUDE.md 問題、D9 subagents、D10 codebase navigation、 harness 修復、agentic…

本地開發 Port 分配登錄。查詢/登記/釋放各專案服務的 port,避免多專案衝突。觸發關鍵字:port 衝突、幫我登記 port、哪個 port 可用、port 被佔用、reserve port、列出 port…

Multi-frontier-model mob review of someone ELSE's PR — review-only, never modifies their code.

解完非平凡 bug 後主動萃取除錯知識的儀式:產出 debug report Markdown、 清理本次留下的過渡產物(註解舊碼、散落 console.log)、封存未採用的實驗方案、 將摘要寫入 ~/.agents/debugs/debug-reports.jsonl,最後提醒手動 /clear。 觸發關鍵字:/debugreport、debug report、debug 完了、除錯報告、bug 解完、 解完 bug、debug 報告、bug…

根據 04-module-structure.md 規範,自動建立新 task module 的完整骨架(7 個檔案)。觸發關鍵字:新增 task、建立 module、new task…

夜間自我改善 Agent — 讀取 transcript/mycelium friction events、聚類後草擬 hookify rule 或 CLAUDE.md gotcha、驗證 failing→passing test、開 PR。每日 03:00…

PR 完成後的 AI 行為審計 control log:agent 從 git log / PR diff / PR body 推論 autonomousdecision、assumption、specdeviation 等 7 類行為 entries, 使用者最多 3 輪校準後寫入 mycelium DB,並產生 .runtime/control-logs/pr- .md markdown artifact(含 11 個 section)。統計 autonomyratio / deviationratio / verificationscore,依閾值給出 rule/hook/skill 補充建議。 觸發關鍵字:control log、行為審計、autonomy ratio、AI 自主決定比例、 spec deviation、pr control log、ai…

Mob review by multiple frontier-model agents — 完整 PR 生命週期含跨家 LLM group review:自動偵測 codex / agy,≥1 家即啟動 R1 獨立 + R2 交叉 debate + aggregate;fix → re-review 直到全員 LGTM(含 actionable NIT)→ 人類快速複查 → CI → merge → spectra archive + Jira sync。 適用中大型 PR / 高風險改動 / 跨家視角壓力測試 / SDD 專案。小型 PR 或快速 lifecycle 請改用 /pr-cycle-fast(Claude-only state machine)。純 PR review 不需完整 lifecycle 請改用 /pr-review-cycle(4 個 pr-review-toolkit subagent 平行)。 偵測不到任何外部模型時提示使用者退回 /pr-review-cycle。 觸發情境:「mob review」「group review」「multi-model PR review」「跨家 LLM review」 「pr-cycle-deep」「frontier model 群審」「找 codex + agy 一起 review」「deep…

PR 生命週期自動化 orchestrator(快速版):偵測 open PR、並行 code review + CI monitor + conflict detect、auto-fix markdownlint/CI、merge 後自動觸發 /pr-retro 寫 mycelium、最後 /clean-merged。支援中斷後 resume。小型 PR 或追求快速 lifecycle 首選;大型 PR 或 SDD 專案請改用…

完整 PR 生命週期(通用版,任何專案皆可用):從建立 PR 到 code-review → parallel review(4 個 pr-review-toolkit subagent) → fix → re-review → CI → merge。無 SDD/spectra 依賴。 SDD 專案(需要 spectra archive + Jira sync + amplifier-verifier)請改用 /pr-cycle-deep。 觸發情境:「跑 PR cycle」「review 這個 PR」「pr-review-cycle」「完整 PR 流程」「parallel…

Spec Kit 五層深度規格展開 + OpenSpec/Spectra 變更管理框架的融合方法論。 適用情境:用戶提到「寫 spec」「寫規格」「展開需求」「需求規格」「proposal」 「openspec」「spectra」「spec kit」「五層展開」「深度規格」「變更管理」 「delta spec」「changes folder」「需求文件結構」時必須觸發。 也適用於:用戶說「幫我把 user story 展開成完整規格」「把需求寫到可以開發的程度」 「設計 API 規格」「建立 proposal」「需求變更追蹤」「寫 AC」「寫驗收條件」等場景。 當用戶貼上功能描述或 User Story 要求產出完整開發規格文件時,必須觸發。 即使用戶只說「幫我把這個功能描述得更清楚」「怎麼定義完成條件」「拆任務」 「spec 怎麼寫」「這個需求太模糊了」,也應觸發此…

以 Kent Beck 的 Test-Driven Development (TDD) 與 Tidy First 方法論驅動軟體開發。 適用情境:用戶提到「TDD」、「測試驅動開發」、「Red Green Refactor」、「先寫測試」、 「test first」、「Kent Beck」、「Tidy First」時必須啟動此 Skill。 也適用於:用戶說「幫我用 TDD 方式開發」、「我想一步一步測試推進」、 「先寫 failing test」、「寫最小測試」、「重構但不改行為」、 「structural vs behavioral change」、「分離結構與行為變更」等場景。 當用戶貼上需求或 plan 要求逐步實作功能、修 bug 要先寫測試重現、 或任何需要嚴格測試循環紀律的開發工作,都應觸發此 Skill。…

驗證 Gemini 模型在 Google AI Studio 與 GCP Vertex AI 上的實際可用性—— 不只是「列在文件上」,而是真正可呼叫並回傳有效輸出。支援 Gemini 3.x global 端點 (gemini-3.1-pro-preview、gemini-3-flash-preview 等只在 global 端點可用)。 當使用者詢問模型可用性、在寫入程式碼或設定前確認模型名稱是否有效、 遇到 404/1011/model-not-found 錯誤、要在版本遷移前審查可用模型、 或在不同 Gemini 版本間做選擇時使用此 skill。 觸發關鍵字:模型是否存在、哪些模型可用、Vertex 找不到模型、 AI Studio 模型測試、gemini 模型驗證、does model exist、which models actually work、 gemini-3.1-pro-preview 不存在、global endpoint 404、Gemini 3…