技能 global-commenting

📦

global-commenting

Name: global-commenting
Author: EIS-ITS

內容修訂 r1 安全 📁 檔案系統存取

撰寫清晰的程式碼註解

品質不佳的註解會過時，並掩蓋重要的設計意圖。此技能可協助 Claude、Codex 和 Claude Code 撰寫精簡註解，用來說明不易看出的邏輯。

支援: Claude Codex Code(CC)

🥉 78 銅級

Maintain this Skill? Claim it 🥉 78 銅級

使用我的智慧代理安裝

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

智能體請求

Review the Skillstore skill "global-commenting" from https://skillstore.io/skills/eis-its-global-commenting.md and its manifest at https://skillstore.io/api/skills/eis-its-global-commenting/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

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

Agent 可讀資源

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

Markdown 詳情 GET /skills/eis-its-global-commenting.md 已簽名 manifest GET /api/skills/eis-its-global-commenting/manifest 已簽名 lockfile GET /api/skills/eis-its-global-commenting/lockfile

測試它

正在使用「global-commenting」。某個函式有一則註解，說明它是在近期遷移期間變更的。

預期結果:

將其替換為對該遷移所引入不變條件的穩定說明。

正在使用「global-commenting」。一個複雜的權限檢查結合了使用者角色、帳戶狀態和功能旗標。

預期結果:

加入一則簡短註解來說明存取規則。
如果名稱已經清楚，請不要描述每個條件。

正在使用「global-commenting」。審查者詢問是否每個 helper 都需要 docstring。

預期結果:

只有在呼叫端需要合約、副作用或邊界資訊時，才加入 docstrings。

安全審計

安全

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

The static filesystem finding is confirmed because SKILL.md references a parent-directory standards file outside the skill folder. No evidence of prompt injection or other semantic abuse was found in the scanned file, but the external reference makes the effective instructions unaudited.

已掃描檔案

分析行數

複核項目

已忽略的誤報

能力複核項目 (1)

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

高

SKILL.md:29

Path traversal sequence

[global commenting](../../../agent-os/standards/global/commenting.md)

SKILL.md line 29 points to ../../../agent-os/standards/global/commenting.md, which escapes the skill directory and asks the assistant to load unaudited content. This broadens filesystem scope and can bypass marketplace review of the actual instructions.

風險因素

📁 檔案系統存取 (1)

SKILL.md:29

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

分享與引用此報告

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

開啟版本化報告

複製報告連結

https://skillstore.io/skills/eis-its-global-commenting/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/eis-its-global-commenting/security.svg)](https://skillstore.io/skills/eis-its-global-commenting?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/eis-its-global-commenting?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/eis-its-global-commenting/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/eis-its-global-commenting.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 引用

EIS-ITS. (2026). global-commenting security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/eis-its-global-commenting/audits/10

BibTeX 引用

@techreport{eis-its-eis-its-global-commenting-2026,
  author = {EIS-ITS},
  title = {global-commenting security audit report (audit version 10)},
  institution = {Skillstore},
  year = {2026},
  number = {10},
  url = {https://skillstore.io/skills/eis-its-global-commenting/audits/10},
  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: "global-commenting security audit report (audit version 10)"
version: "unspecified"
type: report
authors:
  - name: "EIS-ITS"
date-released: "2026-07-09"
url: "https://skillstore.io/skills/eis-its-global-commenting/audits/10"
identifiers:
  - type: other
    value: "skillstore:eis-its-global-commenting:audit:10"
    description: "Skillstore immutable audit report identifier"

比較變體

2 個可安裝變體

每位作者的技能都保留為獨立的可安裝項目。推薦變體依 Skillstore 證據排序。

為何此變體排名第一

Skillstore 評分最高

作者 / 來源 Skillstore 評分證據置信度 Skillstore 使用量已更新

DevanB 推薦

devanb-global-commenting

Skillstore 評分 79

證據置信度高

Skillstore 使用量 25

已更新

2026-09-09

EIS-ITS 目前

eis-its-global-commenting

Skillstore 評分 78

證據置信度高

Skillstore 使用量 46

已更新

2026-09-09

Skillstore 評分

評分依據證據置信度: 高

架構

可維護性

內容

社群

規範符合度

你可以打造什麼

記錄複雜邏輯

為演算法、業務規則和不易看出的取捨加入精簡註解。

改善既有註解

在維護期間審查註解，並用持久的說明取代過時備註。

審查 Pull Requests

檢查新增的註解是否說明意圖，而不是重複描述可讀的程式碼。

試試這些提示

判斷是否需要註解

審查此檔案，找出註解能補充持久脈絡的位置。當註解並非必要時，優先使用更好的命名或結構。

改善既有註解

審查此變更中的既有註解。重寫過時、暫時性或聚焦於近期編輯的註解。

記錄業務邏輯

為此模組中不易看出的業務規則加入註解。說明意圖、限制和取捨，不要重述每一行。

設定註解標準

稽核此元件在函式、類別和 APIs 中的註解品質。為未來變更提出精簡的註解方法。

最佳實務

使用註解說明程式碼無法清楚表達的意圖、限制和取捨。
在加入重述明顯行為的註解之前，先改善命名、結構和測試。
避免日期、票券歷史和暫時性實作備註，讓註解保持持久。

避免

加入逐行敘述直觀程式碼的註解。
保留描述舊行為、近期修正或暫時性變通方法的註解。
用註解彌補不清楚的命名或可避免的複雜度。

常見問題

此技能能協助什麼？

它協助助理撰寫精簡註解和 docstrings，用來說明持久的意圖。

它會為每個函式撰寫註解嗎？

不會。它偏好清晰的程式碼，只有在註解能提供有用脈絡時才加入。

它可以改善既有註解嗎？

可以。它能識別過時、暫時性或顯而易見的註解，並建議更清楚的替代內容。

它支援 docstrings 嗎？

可以。它適用於 docstrings、函式文件、APIs、類別和原始碼註解。

它可以取代團隊風格指南嗎？

不能。它提供一般註解指引，並應遵循本地專案標準。

哪些助理可以使用它？

報告標示它相容於 Claude、Codex 和 Claude Code。

開發者詳細資訊

作者

EIS-ITS

授權

MIT

Skillstore 修訂

版本提示

作者未聲明版本。

儲存庫

https://github.com/EIS-ITS/vss-cli/tree/main/.claude/skills/global-commenting

引用

26421118b848d9f1efc0aa169d8a7a9e7e0a877e

維護新鮮度

2026/7/18

使用量

7 次下載 · 216 次瀏覽

檔案結構

管理情境驅動開發

由 wshobson

當產品目標、技術堆疊選擇和工作流程規則分散各處時，AI 輔助專案會失去一致性。此技能會透過 Conductor 情境成品，引導 Claude、Codex 和 Claude Code。

程式開發查看

global-commenting

使用我的智慧代理安裝

Agent 可讀資源

測試它

安全審計

風險因素

複製報告連結

Markdown 徽章

HTML 徽章

嵌入卡片

APA 引用

BibTeX 引用

CITATION.cff

比較變體

Skillstore 評分

你可以打造什麼

記錄複雜邏輯

改善既有註解

審查 Pull Requests

試試這些提示

最佳實務

避免

常見問題

開發者詳細資訊

EIS-ITS 的更多技能

frontend-components

frontend-accessibility

global-coding-style

testing-test-writing

global-validation

frontend-css

相關技能

code-review

code-analysis

gauntlet

nestjs-code-audit

code-reviewer

context-driven-development