Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

Code Comment Cn · yangge521 | DecimalAI

codingby yangge521

Code Comment Cn

yangge521/code-comment-cn

Source yangge521/dev-skills-zh ↗License MIT

中文代码注释规范与自动生成，支持 Python/JavaScript/Go/Java 多语言

SkillScore95Maintained

Automatic

Coding pack

Last verified 8/3/2026

What it changes

Passed 21 of 22 test cases with the skill, and 16 of 22 without it.

Without skill73%

With skill95%

Checks it passed that the model alone missed

The TODO comment includes a date
The file header includes author and creation date metadata
Uses Chinese for the primary explanation while keeping code identifiers in English

and 2 more in the full report

5 fixed16 passed either way1 still failing0 broke

Pass-rate lift: +23 pp
Tokens: +26%
Agent turns: 0%
Response time: -1%

Model gemini-3.6-flashMeasured 8/3/2026v121 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/yangge521-code-comment-cn/SKILL.md https://app.decimal.ai/s/yangge521-code-comment-cn/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add yangge521-code-comment-cn, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/yangge521-code-comment-cn/ and pins it in .decimal/skills.lock

decimalai skills add yangge521-code-comment-cn

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/yangge521-code-comment-cn/SKILL.md https://app.decimal.ai/s/yangge521-code-comment-cn/SKILL.md

Raw file: /s/yangge521-code-comment-cn/SKILL.md ↗ · machine-readable summary at /s/yangge521-code-comment-cn.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

What's inside

The instructions your model reads when the skill loads.

SKILL.md65 linessingle file

中文代码注释规范

概述

提供多语言代码注释规范，确保代码可读性和可维护性。支持 Python（docstring）、JavaScript（JSDoc）、Go、Java 等语言。

使用场景

新项目启动：建立代码注释规范
代码审查：检查注释完整性
老项目重构：补充缺失注释
API 开发：函数/类接口注释
GPU 推理代码：复杂逻辑注释
团队协作：统一注释风格

注释规范

Python（Google 风格 docstring）

函数注释包含：功能描述、Args（参数名/类型/说明）、Returns（返回值类型/说明）、Raises（异常）、Example（示例）。

JavaScript（JSDoc）

使用 @param/@returns/@throws 标签，支持类型推断。

通用规则

文件头注释：文件功能、作者、创建日期
类注释：类的职责和使用方式
复杂逻辑：解释"为什么"而非"做什么"
TODO/FIXME：标注待办和已知问题
中文注释，技术术语保留英文

常见问题与排查

问题	原因	解决方案
注释与代码不一致	修改代码未更新注释	CI 检查注释同步
过度注释	注释显而易见的代码	只注释复杂逻辑
注释风格不统一	无规范约束	使用 lint 工具检查

Track record

Benchmark

21 / 22

test cases passed, vs 16 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/1/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

yangge521 / dev-skills-zh

skills/engineering/code-comment-cn/SKILL.md

View on GitHub ↗

License MITImported 8/1/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.