技能 build-diagnostics
📦
build-diagnostics
內容修訂 r1 安全 ⚙️ 外部命令📁 檔案系統存取
透過根本原因分析診斷建置失敗
建置阻礙常隱藏在不清楚的記錄、損壞的設定或不完整的測試之後。此技能會引導 Claude、Codex 和 Claude Code 完成診斷、修復規劃、驗證與升級處理。
支援: Claude Codex Code(CC)
使用我的智慧代理安裝
將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。
智能體請求
Review the Skillstore skill "build-diagnostics" from https://skillstore.io/skills/cleanexpo-build-diagnostics.md and its manifest at https://skillstore.io/api/skills/cleanexpo-build-diagnostics/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。
測試它
正在使用「build-diagnostics」。 Next.js 建置因無法寫入 manifest 而失敗。
預期結果:
報告會識別失敗的寫入步驟、檢查設定與輸出路徑、提出最可能的目錄或權限原因，並列出驗證步驟。
正在使用「build-diagnostics」。 某個 typecheck 作業在介面變更後回報許多相關的指派錯誤。
預期結果:
回應會依變更的合約將錯誤分組、識別受影響的呼叫位置、建議最小映射修復，並將 typecheck 通過定義為成功標準。
正在使用「build-diagnostics」。 某個測試套件缺少涵蓋率，且失敗原因不明確。
預期結果:
診斷會將缺少測試與測試失敗分開、檢視可運作的範例，並說明該阻礙需要實作、釐清範圍或升級處理。
安全審計
安全v8 • 2026/7/5 開啟版本化報告
No evidence found of malicious intent, prompt injection, credential access, network exfiltration, or embedded executable code. The static findings are false positives caused by Markdown fences, inline command names, and a filesystem remediation example in a diagnostic guide.
1
已掃描檔案
233
分析行數
0
複核項目
0
已忽略的誤報
風險因素
⚙️ 外部命令 (22)
SKILL.md:18-26 SKILL.md:26-48 SKILL.md:48-54 SKILL.md:54-60 SKILL.md:60-78 SKILL.md:78-82 SKILL.md:82-93 SKILL.md:93-97 SKILL.md:97-108 SKILL.md:108-113 SKILL.md:113-114 SKILL.md:114 SKILL.md:119-133 SKILL.md:133-138 SKILL.md:138-141 SKILL.md:141-146 SKILL.md:146-149 SKILL.md:149-154 SKILL.md:154-157 SKILL.md:157-162 SKILL.md:162-194 SKILL.md:194-210
📁 檔案系統存取 (1)
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/cleanexpo-build-diagnostics/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/cleanexpo-build-diagnostics?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/cleanexpo-build-diagnostics?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/cleanexpo-build-diagnostics/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/cleanexpo-build-diagnostics.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 引用
CleanExpo. (2026). build-diagnostics security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/cleanexpo-build-diagnostics/audits/8BibTeX 引用
@techreport{cleanexpo-cleanexpo-build-diagnostics-2026,
author = {CleanExpo},
title = {build-diagnostics security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/cleanexpo-build-diagnostics/audits/8},
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: "build-diagnostics security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "CleanExpo"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/cleanexpo-build-diagnostics/audits/8"
identifiers:
- type: other
value: "skillstore:cleanexpo-build-diagnostics:audit:8"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高 55
架構
85
可維護性
87
內容
71
社群
91
規範符合度
你可以打造什麼
解決 CI 建置失敗
調查失敗的建置作業、蒐集記錄、找出根本原因，並提出已驗證的修復計畫。
偵錯型別檢查阻礙
在套用最小修復之前，將 TypeScript 錯誤追溯到已變更的介面、不正確用法或過時模式。
清楚升級處理困難阻礙
彙整已確認事實、失敗嘗試、可能原因，以及需要維護者做出的決策。
試試這些提示
開始基本建置調查
Use the build-diagnostics skill to investigate this build failure. Reproduce the error, collect the main logs, inspect likely configuration files, and summarize the root cause with confidence.
比較可能的根本原因
Use the build-diagnostics workflow to rank possible causes for this blocker. Explain the evidence for each cause, the missing information, and the safest next check.
規劃並驗證最小修復
Use the build-diagnostics skill to design a minimal fix. Include the current state, proposed change, risk level, validation steps, success criteria, and rollback plan.
準備升級處理報告
Use the build-diagnostics escalation format. Report what is known, what was tried, why it failed, ranked possible causes, and the exact decisions needed.
最佳實務
- 在變更檔案之前先重現阻礙。
- 區分症狀與根本原因，並引用具體證據。
- 在產生失敗的相同條件下驗證修復。
避免
- 在理解失敗路徑之前就變更程式碼。
- 將通過的局部檢查視為完整驗證。
- 在沒有事實、已嘗試步驟與明確所需決策的情況下升級處理。
常見問題
此技能能協助診斷什麼？
它有助於診斷建置失敗、型別檢查錯誤、測試阻礙、設定問題與不明確的 CI 失敗。
它會自動執行命令嗎？
不會。它為代理程式或使用者提供診斷指引，以便在正常核准下執行適當的專案命令。
它預期使用哪些工具？
它會在這些工具可用時參考 Bash、檔案讀取、搜尋、文件查詢、網路搜尋與 Playwright。
它能修復所有建置失敗嗎？
不能。它有助於找出並驗證可能的修復，但有些阻礙需要維護者或架構決策。
它如何處理不確定性？
它會要求提供信心水準、替代原因、驗證計畫，並在證據不完整時進行升級處理。
它對 Claude Code 和 Codex 有用嗎？
是。當 Claude、Codex 和 Claude Code 能檢查檔案並執行已核准檢查時，此工作流程與它們相容。