技能 file-header-guardian
📦

file-header-guardian

內容修訂 r1 安全 ⚙️ 外部命令

新增一致的檔案標頭註解

當原始碼檔案缺少明確的用途與依賴關係說明時，團隊會失去脈絡。此技能會引導 Claude、Codex 和 Claude Code 為支援的程式碼檔案新增精簡的標頭註解。

支援: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 77 銅級

使用我的智慧代理安裝

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

智能體請求
Review the Skillstore skill "file-header-guardian" from https://skillstore.io/skills/dimon94-file-header-guardian.md and its manifest at https://skillstore.io/api/skills/dimon94-file-header-guardian/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

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

Agent 可讀資源

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

Markdown 詳情 GET /skills/dimon94-file-header-guardian.md 已簽名 manifest GET /api/skills/dimon94-file-header-guardian/manifest 已簽名 lockfile GET /api/skills/dimon94-file-header-guardian/lockfile

測試它

正在使用「file-header-guardian」。 建立了一個新的使用者服務檔案，但沒有標頭。

預期結果:

回應會新增精簡標頭，指出資料庫依賴關係、服務操作和模組角色。

正在使用「file-header-guardian」。 已修改的 Python 模組現在會呼叫快取輔助工具，但標頭已過時。

預期結果:

回應會更新依賴關係說明，並使模組用途與實作保持一致。

正在使用「file-header-guardian」。 一組變更包含樣式表、產生的宣告檔案和 shell 指令碼。

預期結果:

回應會略過豁免檔案，並只將契約標頭新增到指令碼檔案。

安全審計

安全
v8 • 2026/7/6 開啟版本化報告

All seven static findings are false positives caused by Markdown code fences in SKILL.md. The skill provides file header comment templates and exemptions, with no evidence of command execution, prompt injection, data exfiltration, or malicious intent.

1
已掃描檔案
57
分析行數
0
複核項目
0
已忽略的誤報

風險因素

⚙️ 外部命令 (7)
SKILL.md:13-20 SKILL.md:20-23 SKILL.md:23-30 SKILL.md:30-33 SKILL.md:33-38 SKILL.md:38-42 SKILL.md:42-50
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告

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

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/dimon94-file-header-guardian/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/dimon94-file-header-guardian/security.svg)](https://skillstore.io/skills/dimon94-file-header-guardian?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/dimon94-file-header-guardian?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/dimon94-file-header-guardian/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/dimon94-file-header-guardian.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 引用

Dimon94. (2026). file-header-guardian security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dimon94-file-header-guardian/audits/8

BibTeX 引用

@techreport{dimon94-dimon94-file-header-guardian-2026, author = {Dimon94}, title = {file-header-guardian security audit report (audit version 8)}, institution = {Skillstore}, year = {2026}, number = {8}, url = {https://skillstore.io/skills/dimon94-file-header-guardian/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: "file-header-guardian security audit report (audit version 8)" version: "unspecified" type: report authors: - name: "Dimon94" date-released: "2026-07-06" url: "https://skillstore.io/skills/dimon94-file-header-guardian/audits/8" identifiers: - type: other value: "skillstore:dimon94-file-header-guardian:audit:8" description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據 證據置信度: 高
55
架構
85
可維護性
85
內容
70
社群
83
規範符合度

你可以打造什麼

標準化新服務

建立新的應用程式服務檔案時，新增用途與依賴關係說明。

檢視文件漂移

在程式碼變更後，檢查檔案標頭是否仍符合行為。

保持代理工作可追蹤

協助 AI 程式碼工作階段為未來維護者留下精簡脈絡。

試試這些提示

新增基本標頭 
建立此原始碼檔案，並在實作之前新增必要的 @input、@output 和 @pos 標頭註解。
更新現有標頭 
檢視此已變更的檔案，並更新其標頭註解，使依賴關係、匯出項目和系統角色保持準確。
檢查豁免項目 
檢視這些已變更的檔案，並只在此技能適用的位置新增標頭。略過 config、style、產生的檔案和依賴檔案。
同步本機文件 
稽核此功能資料夾，更新適用的檔案標頭，並使相關目錄 CLAUDE.md 註記與目前檔案角色保持一致。

最佳實務

  • 在理解實際依賴關係和匯出行為後撰寫標頭。
  • 保持每個標頭足夠精簡，便於在一般程式碼審查中維護。
  • 當檔案角色發生實質變更時，更新目錄文件。

避免

  • 不要新增只重述檔名的通用標頭。
  • 不要強制將標頭加入豁免的產生檔案、config、style 或依賴檔案。
  • 不要在變更依賴關係或模組職責後，讓標頭維持不變。

常見問題

此技能會執行指令嗎？
不會。它只提供文件範本和工作流程指示。
範本中展示了哪些檔案類型？
此技能包含 TypeScript、JavaScript、Python 和 shell 檔案的範例。
它能自動判斷每個依賴關係嗎？
不能。代理仍需要專案脈絡，才能撰寫準確的 @input 註記。
產生的檔案應該收到標頭嗎？
不應該。此技能明確豁免產生的宣告檔案和依賴目錄。
它與 CLAUDE.md 有什麼關係？
它會提醒代理保持檔案標頭和相關目錄文件同步。
這在 Claude Code 之外也有用嗎？
有。此指引也能協助 Claude 和 Codex 維持一致的檔案文件。

開發者詳細資訊

作者

Dimon94

授權

MIT

Skillstore 修訂

r1

版本提示

作者未聲明版本。

儲存庫

https://github.com/Dimon94/cc-devflow/tree/main/.claude/skills/file-header-guardian

引用

72d5025b022c77f7a51bdf5c1637c689c80e89d1

維護新鮮度

2026/7/22

使用量

7 次下載 · 210 次瀏覽

檔案結構

📄 SKILL.md

Dimon94 的更多技能

查看全部

相關技能

查看全部