技能 root-cause-tracing

📦

root-cause-tracing

Name: root-cause-tracing
Author: DYAI2025

內容修訂 r1 中風險 ⚙️ 外部命令📁 檔案系統存取🔑 環境變數

追蹤複雜錯誤中的根本原因

複雜錯誤通常出現在距離原始觸發點很遠的位置。此技能會引導你向後追蹤、進行目標式插樁，以及隔離測試以找出來源。

支援: Claude Codex Code(CC)

⚠️ 50 差

Maintain this Skill? Claim it ⚠️ 50 差

安裝前請停止並請求確認。

請審查安裝計畫，並在變更檔案前取得使用者明確同意。

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求

Review the Skillstore skill "root-cause-tracing" from https://skillstore.io/skills/dyai2025-root-cause-tracing.md and its manifest at https://skillstore.io/api/skills/dyai2025-root-cause-tracing/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/dyai2025-root-cause-tracing.md 已簽名 manifest GET /api/skills/dyai2025-root-cause-tracing/manifest 已簽名 lockfile GET /api/skills/dyai2025-root-cause-tracing/lockfile

測試它

正在使用「root-cause-tracing」。測試套件在套件資料夾內留下 .git 目錄。

預期結果:

直接原因：git 初始化使用了錯誤的工作目錄。追蹤呼叫者，直到找到空白專案目錄值被引入的位置。

正在使用「root-cause-tracing」。資料庫在專案根目錄中開啟，而不是在暫存目錄中開啟。

預期結果:

從 open 呼叫開始。記錄目錄參數、呼叫者堆疊與測試設定時序。修正第一個無效路徑來源。

正在使用「root-cause-tracing」。某個失敗操作只在完整測試套件執行後才出現。

預期結果:

執行聚焦的測試群組，觀察不需要的狀態，並在第一個可重現的測試處停止。接著檢查該測試的設定路徑。

安全審計

中風險

v12 • 2026/7/9 開啟版本化報告

Most SKILL.md static findings are false positives from Markdown fences, inline code, and examples. The real risk is intentional local command execution through the Bash helper and documented npm workflows. Debug guidance should also avoid broad environment logging.

已掃描檔案

239

分析行數

複核項目

已忽略的誤報

已確認的安全問題 (2)

中

SKILL.md:92-110 find-polluter.sh:41-42

Local Test Command Execution

The skill instructs users to run npm test and a helper script that runs npm test for matched files. This can execute arbitrary project test scripts in the workspace.

The documentation shows npm test usage and the helper directly invokes npm test. This is intentional local execution, so the risk is clear but not malicious by itself.

中

SKILL.md:75-87 SKILL.md:163-166

Debug Logging May Expose Environment Data

The guidance recommends logging runtime context, including environment variables. Agents could copy sensitive values into test output or shared logs if not constrained.

The concrete example logs NODE_ENV, and the later guidance mentions environment variables broadly. The risk depends on how users apply the advice.

能力複核項目 (1)

這些是真實的本機能力，對此技能而言可能是預期行為，因此需要複核，但不會按已確認的惡意行為計分。

中

find-polluter.sh:1

Unix shell invocation

#!/bin/bash

The shebang identifies an executable Bash helper that runs local workspace commands, including npm tests. This is intentional, but it creates script-execution risk for users.

風險因素

審計單位: codex 檢視審計紀錄 →

分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告

複製報告連結

https://skillstore.io/skills/dyai2025-root-cause-tracing/audits/12?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/dyai2025-root-cause-tracing/security.svg)](https://skillstore.io/skills/dyai2025-root-cause-tracing?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/dyai2025-root-cause-tracing?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/dyai2025-root-cause-tracing/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/dyai2025-root-cause-tracing.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

學術引用 (APA · BibTeX · CFF)

APA 引用

DYAI2025. (2026). root-cause-tracing security audit report (audit version 12) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dyai2025-root-cause-tracing/audits/12

BibTeX 引用

@techreport{dyai2025-dyai2025-root-cause-tracing-2026,
  author = {DYAI2025},
  title = {root-cause-tracing security audit report (audit version 12)},
  institution = {Skillstore},
  year = {2026},
  number = {12},
  url = {https://skillstore.io/skills/dyai2025-root-cause-tracing/audits/12},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "root-cause-tracing security audit report (audit version 12)"
version: "unspecified"
type: report
authors:
  - name: "DYAI2025"
date-released: "2026-07-09"
url: "https://skillstore.io/skills/dyai2025-root-cause-tracing/audits/12"
identifiers:
  - type: other
    value: "skillstore:dyai2025-root-cause-tracing:audit:12"
    description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據證據置信度: 中

架構

可維護性

內容

社群

規範符合度

你可以打造什麼

追蹤深層執行階段失敗

從可見錯誤開始，沿著呼叫者向後追蹤，直到找到第一個無效輸入。

識別造成污染的測試

隔離執行測試，找出哪個測試建立了非預期檔案或持久狀態。

加入防禦性驗證

將追蹤出的根本原因轉化為原始碼層級的驗證，以及跨呼叫鏈的防護機制。

試試這些提示

追蹤可見錯誤

Use root-cause-tracing for this error: [paste symptom]. 沿著可能的呼叫者向後追蹤，並識別最早應檢查的輸入。

規劃插樁

Use root-cause-tracing to plan safe instrumentation for this failing operation: [operation]. 包含要記錄的內容與應避免記錄的內容。

找出測試污染

Use root-cause-tracing to identify which test creates [file or state]. 在執行命令前建議安全的隔離工作流程。

設計原始碼修正

Use root-cause-tracing on this call chain: [call chain]. 提出原始碼修正方式與防止再次發生的防禦層。

最佳實務

從精確症狀開始，然後一次向上一層呼叫者追蹤。
只記錄足以證明資料流的上下文，並避免記錄機密。
修正原始觸發原因，然後在重要邊界加入驗證。

避免

只修補錯誤出現的那一行。
在確認對工作區的影響前執行廣泛的 shell 命令。
將完整環境變數或大量日誌傾印到除錯輸出中。

常見問題

我應該何時使用此技能？

當錯誤出現在執行深處，且原始不良輸入不清楚時使用。

它會自動執行命令嗎？

此技能提供命令範例與輔助腳本。使用者應在執行前核准並檢閱命令。

哪些專案最適合？

它適合具有堆疊追蹤、測試與分層呼叫的程式碼庫，尤其是資料會跨邊界變更的情境。

它能找出測試污染嗎？

可以。內含的輔助工具可執行符合條件的 npm 測試，並在不需要的狀態出現時停止。

我應該避免記錄什麼？

避免記錄機密、權杖、完整環境傾印、私有路徑與客戶資料，除非它們已經過遮蔽處理。

它僅限於 TypeScript 嗎？

不是。範例使用 TypeScript，但追蹤方法適用於許多語言與測試框架。

開發者詳細資訊

作者

DYAI2025

授權

MIT

Skillstore 修訂

版本提示

作者未聲明版本。

儲存庫

https://github.com/DYAI2025/Stoppclock-page/tree/main/stoppclock_speckit/.claude/commands/skills/root-cause-tracing

引用

3e4b6c31a74a3bd1a291c98cf585d720cb9fbc88

維護新鮮度

2026/7/18

使用量

8 次下載 · 273 次瀏覽

檔案結構

📄 find-polluter.sh

📄 SKILL.md

📄 SKILL.zip

DYAI2025 的更多技能

查看全部

📦

pdf

自動化 PDF 工作流程

PDF 工作通常需要在多個工具之間重複進行擷取、合併和表單填寫。此技能為 Claude、Codex 和 Claude Code 提供用於本機 PDF 處理的結構化指引與指令碼。

辦公與報告查看

📦

meeting-insights-analyzer

分析會議溝通模式

會議逐字稿包含有用的訊號，但手動檢視需要時間。這項技能會將逐字稿轉換為聚焦的溝通回饋，並提供範例與後續步驟。

溝通查看

📦

changelog-generator

從 Git 提交產生清晰的變更日誌

當提交訊息過於技術性或不一致時，撰寫版本說明會很耗時。此技能會將 git 歷史記錄轉換成適合客戶、團隊和發布渠道的清晰變更日誌。

文件查看

📦

brand-guidelines

套用 Anthropic 品牌指南

團隊在建立品牌化產出物時，需要一致的視覺樣式。此技能提供 Anthropic 色彩、字體排印，以及適用於 Claude、Codex 和 Claude Code 工作流程的使用指南。

設計與創意查看

📦

content-research-writer

更快速起草經研究的內容

長篇寫作常常會因為研究、結構、引用和修訂分散在不同步驟而停滯。此技能會引導 Claude、Codex 或 Claude Code 完成大綱規劃、來源蒐集、草稿回饋和最終潤飾。

寫作與內容查看

📦

image-enhancer

強化影像以獲得更清晰的視覺效果

低品質的螢幕截圖可能會讓文件、簡報和社群貼文難以閱讀。此技能會引導影像強化、放大、銳化、減少瑕疵，以及輸出選擇。

設計與創意查看

查看全部

📦

debugging

偵錯錯誤與根本原因

由 89jobrien

當證據分散在日誌、堆疊追蹤與服務之間時，錯誤和事件很難分流判斷。此技能會結構化診斷流程、解析日誌、識別模式，並引導最小修復。

程式開發查看

📦

systematic-debugging

有系統地偵錯軟體問題

由 Asmayaseen

缺乏結構的錯誤修復會浪費時間，並可能掩蓋真正的失敗原因。此技能會引導 Claude、Codex 和 Claude Code 進行以證據為基礎的根本原因分析。

程式開發查看

📦

debugger

有系統地除錯軟體故障

由 shubhamsaboo

當症狀掩蓋真正原因時，錯誤會浪費工程時間。此技能會引導 Claude、Codex 和 Claude Code 進行結構化調查、假設測試、修復與預防。

程式開發查看

📦

bug-diagnose-and-root-cause-and-fix

診斷錯誤並規劃修復

由 727474430

軟體故障的原因往往不明確，證據也分散各處。此技能會引導 Claude、Codex 和 Claude Code 產出結構化診斷報告，並提供實用的修復步驟。

程式開發查看

📦

error-debugging-error-analysis

更快速診斷正式環境錯誤

由 sickn33

當日誌、追蹤資料和版本發布分散各處時，偵錯正式環境錯誤會很緩慢。此技能會引導 Claude、Codex 和 Claude Code 進行結構化的根本原因分析與可觀測性改善。

程式開發查看

📦

debugging-toolkit-smart-debug

以證據除錯生產環境問題

由 sickn33

當日誌、追蹤資料與程式碼證據分散各處時，複雜故障很難分診。此技能會引導 Claude、Codex 和 Claude Code 進行結構化診斷、修復規劃與驗證。

程式開發查看

root-cause-tracing

使用我的智慧代理安裝

Agent 可讀資源

測試它

安全審計

已確認的安全問題 (2)

風險因素

複製報告連結

Markdown 徽章

HTML 徽章

嵌入卡片

APA 引用

BibTeX 引用

CITATION.cff

Skillstore 評分

你可以打造什麼

追蹤深層執行階段失敗

識別造成污染的測試

加入防禦性驗證

試試這些提示

最佳實務

避免

常見問題

開發者詳細資訊

DYAI2025 的更多技能

pdf

meeting-insights-analyzer

changelog-generator

brand-guidelines

content-research-writer

image-enhancer

相關技能

debugging

systematic-debugging

debugger

bug-diagnose-and-root-cause-and-fix

error-debugging-error-analysis

debugging-toolkit-smart-debug