スキル global-commenting
📦

global-commenting

コンテンツリビジョン r1 安全 📁 ファイルシステムへのアクセス

撰寫清晰且長期適用的程式碼註解

團隊經常加入會過時或重複顯而易見程式碼的註解。這項技能會引導 AI 助理撰寫最少量的註解，用來說明不明顯的決策。

対応: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 79 ブロンズ

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト
Review the Skillstore skill "global-commenting" from https://skillstore.io/skills/devanb-global-commenting.md and its manifest at https://skillstore.io/api/skills/devanb-global-commenting/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

Markdown詳細 GET /skills/devanb-global-commenting.md 署名済み manifest GET /api/skills/devanb-global-commenting/manifest 署名済み lockfile GET /api/skills/devanb-global-commenting/lockfile

テストする

「global-commenting」を使用しています。 某個服務方法包含多則重述每個賦值和條件的註解。

期待される結果:

審查會移除冗餘註解，並保留一則簡短說明，用來解釋該條件背後的商業規則。

「global-commenting」を使用しています。 某個 TypeScript 函式包含複雜的日期邏輯，但沒有背景脈絡。

期待される結果:

結果會加入精簡的 TSDoc 摘要，以及一則解釋日曆規則的行內註解。

「global-commenting」を使用しています。 某個 pull request 加入了關於暫時性遷移 workaround 的註解。

期待される結果:

審查會建議移除有時效限制的措辭，並記錄相容性檢查的穩定原因。

セキュリティ監査

安全
v10 • 2026/7/9 バージョン別レポートを開く

The static path traversal alert is a fixed Markdown link to a project standards document, not executable code or user-controlled file access. No prompt injection, data exfiltration, or malicious intent was found in SKILL.md.

1
スキャンされたファイル
27
解析済み行数
0
レビュー項目
0
誤検知を無視

リスク要因

📁 ファイルシステムへのアクセス (1)
SKILL.md:26
最新の完了済み静的・セマンティック監査では、確認済みのセキュリティ検出事項は見つかりませんでした。これは、スキルに副作用がないことを証明するものではありません。
監査者: codex 監査履歴を表示 →
このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く
セキュリティ評価

レポートリンクをコピー

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

Markdownバッジ

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

HTMLバッジ

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

埋め込みカード

<iframe src="https://skillstore.io/embed/skills/devanb-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形式の引用

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

BibTeX形式の引用

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

バリアントを比較

インストール可能なバリアント 2 件

各作者のスキルは個別のインストール項目として維持されます。推奨バリアントは 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 スコア

このスコアの理由 証拠の信頼度: 高
55
アーキテクチャ
85
保守性
87
コンテンツ
70
コミュニティ
91
仕様準拠

作成できるもの

改善既有程式碼註解

審查程式碼庫中的註解，並只保留能解釋長期背景脈絡的註解。

標準化 Docblocks

建立符合最小化註解風格的 PHPDoc、JSDoc 或 TSDoc 註解。

減少註解雜訊

找出重複程式碼行為的註解，並建議更清楚的命名或結構。

これらのプロンプトを試す

加入必要註解 
審查這段程式碼，並只加入能解釋不明顯決策的註解。避免加入重複程式碼已表達內容的註解。
撰寫 Docblocks 
在有助於未來維護者的地方加入 PHPDoc、JSDoc 或 TSDoc 註解。讓每則註解保持精簡，並聚焦於意圖。
審查註解品質 
審查此變更中的既有註解。標記過時、冗餘或暫時性的註解，並只在需要時建議持久適用的替代內容。
先重構再加註解 
找出可透過更清楚的命名或結構來移除註解需求的地方。只針對仍不明顯的商業規則或演算法加入註解。

ベストプラクティス

  • 當原因無法從命名和結構中看出時，說明程式碼存在的理由。
  • 在加入註解之前，優先讓程式碼本身更清楚。
  • 避免發布日期、暫時性說明和近期變更歷史，讓註解保持長期適用。

回避

  • 不要為每一行都加註解，或重複顯而易見的控制流程。
  • 不要在邏輯變更後保留過時註解。
  • 不要用註解掩蓋不清楚的命名或過於複雜的結構。

よくある質問

這項技能可以協助什麼？
它協助 AI 助理撰寫更少但更好的程式碼註解，用來解釋不明顯的意圖。
它提到哪些語言？
它提到 PHP、TypeScript、JavaScript、PHPDoc、JSDoc 和 TSDoc。
它會產生完整文件嗎？
不會。它聚焦於程式碼註解和 docblocks，而不是完整的專案文件。
它可以移除註解嗎？
可以。它能引導移除過時、冗餘或暫時性的註解。
它會自動強制執行風格嗎？
不會。它為 AI 助理提供指引，並不會執行 linter。
是否包含詳細標準？
沒有。此技能連結到封裝技能目錄之外的標準檔案。

開発者情報

作成者

DevanB

ライセンス

MIT

Skillstore リビジョン

r1

バージョンに関する注意

作者はバージョンを宣言していません。

リポジトリ

https://github.com/DevanB/lucidlog/tree/master/.claude/skills/global-commenting

参照

0519034dad657fb1f7706e0550e962beeda73fdf

メンテナンスの新しさ

2026/7/18

利用状況

12 ダウンロード · 204 閲覧

ファイル構成

📄 SKILL.md

DevanB のその他のスキル

すべて表示

関連スキル

すべて表示