by 安全扫描
OpenClaw
安全
high confidenceThis 技能's requirements and instructions are internally consistent with its 状态d purpose of rewriting code comments into concise Chinese — no unexpected 凭证s, 安装s, or 系统 访问 are 请求ed.
评估建议
This 技能 应用ears coherent for the task of normalizing comments into concise Chinese and will not ask for secrets or 安装 software. Before enabling it broadly, test it on representative code: 验证 it does not 移除 required license headers, legal attributions, 工具-specific annotations (e.g., @生成d, eslint-disable, TODOs used by triage), or comments relied on by tests or 工具ing. If you need those preserved, 添加 an explicit rule to the prompt (e.g., "preserve file headers that contAIn 'Copyright' or 'License', ...详细分析 ▾
✓ 用途与能力
The name/description (comment normalization for code) matches the 技能.md instructions. No binaries, env vars, 安装s, or config paths are required that would be unrelated to comment rewriting.
ℹ 指令范围
Instructions are narrowly focused on removing or rewriting comments and preserving executable code, which is coherent. However the rules are aggressive about deleting 'obvious' comments and converting all comments to Chinese; the 技能 gives no 图形界面dance to preserve legal/license headers, contributor attributions, TODOs that might be 导入ant, or comments used by 工具ing/tests. Also it mandates wr应用ing 输出s in language-specific Markdown code blocks and emitting no explanatory text, which could conflict with some host 流水线s if not anticipated.
✓ 安装机制
Instruction-only 技能 with no 安装 spec and no code files — lowest-risk 安装 性能分析.
✓ 凭证需求
The 技能 请求s no 环境 variables, 凭证s, or 访问 to config paths; its declared needs are proportional to its 状态d purpose.
✓ 持久化与权限
始终为 false，且没有迹象表明该 skill 请求持久/特权 agent 驻留，或修改其他 skill 或系统设置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/21
- 首发版本，提供全局注释规范约束能力 - 针对所有主流编程语言，统一输出资深开发者风格的纯中文精简注释 - 删除解释字面意思、冗长、AI 风格的注释，仅保留 Why 相关内容 - 行内注释极度精简，Doc 注释重写为大厂惯用表达 - 保证代码完整可运行，仅处理注释内容
● 无害
安装命令
点击复制官方npx clawhub@latest install code-comment
镜像加速npx clawhub@latest install code-comment --registry https://cn.longxiaskill.com
技能文档
#Code Comment 技能 清洗代码中的 AI 味注释，输出可直接运行的完整文件。
角色定位
资深 Tech Lead 视角：极度反感冗长、机器翻译腔、解释字面意思的注释。核心规则
1. 删繁就简 — No Obvious Comments
坚决删除所有解释"代码字面意思"的废话。 删除示例： ``
i++ // 将 i 的值增加 1
列出.clear() // 清空列表
return 结果 // 返回结果
`
以上全部删掉，不需要任何替代。
2. 聚焦 Why，而非 What
只保留以下四类注释：
- 业务背景：为什么要有这段逻辑
- 复杂算法概括：非显而易见的算法意图
- 边界/兜底逻辑：特殊情况的处理原因
- 危险操作警告：副作用、性能陷阱、并发风险等
3. 拒绝翻译腔
消除以下表达模式：
- "这个函数被用来..."
- "它将返回..."
- "为了防止发生不可预见的错误..."
- "该方法用于处理..."
人类开发者写注释极少在单行注释末尾加句号，去掉句末标点。
4. 纯中文输出
所有英文注释、中英夹杂注释，全部转换为地道纯中文。
注释处理策略
行内注释 / 单行注释
执行最严格的精简：能不写就不写。必须写时，限制在 5 个词以内。
好的行内注释示例：
`
// 边界拦截
// 防抖兜底
// 透传数据
// 降级处理
// 幂等校验
`
函数/类文档注释（Docstring / JSDoc / KDoc）
保留 @param、@return、@throws 等结构化标签，但重写描述文本，使用大厂惯用表达。
术语映射表
| AI 味写法 | 重构为 |
|-----------|--------|
| 作为默认的后备值 | 兜底 / 默认兜底 |
| 传递给下一个函数 | 透传 |
| 检查是否为空/未定义 | 判空 / 非空校验 / 拦截 |
| 发送网络请求获取数据 | 拉取数据 |
| 传入的参数 | 入参 |
| 返回的结果 | 出参 |
| 遍历这个数组 | （删掉，废话） |
| 初始化变量 | （删掉，废话） |
| 将结果存储到变量中 | （删掉，废话） |
| 调用xxx方法来处理 | （删掉，废话） |
| 如果条件为真则... | （删掉，废话） |
| 捕获并处理异常 | 异常兜底 |
| 确保线程安全 | 加锁 / 并发保护 |
| 这是一个工具类 | 工具类 |
| 用于格式化输出 | 格式化 |
各语言注释语法参考
| 语言 | 单行 | 块注释 | 文档注释 |
|------|------|--------|----------|
| Java | // | / / | /* / |
| Kotlin | // | / / | /* / (KDoc) |
| C++ | // | / / | /// 或 /* / |
| JavaScript / TypeScript | // | / / | /* / (JSDoc) |
| React (JSX/TSX) | {/ /} JSX内 / // JS内 | / / | /* / |
| Python | # | — | """docstring""" |
| Rust | // | / / | /// (外部) / //! (模块) |
| Go | // | / / | // (godoc 格式) |
注意：JSX 模板内的注释必须用 {/ /}，不能用 //，处理 React 文件时严格区分。
输出要求
- 绝对不修改任何执行逻辑、变量名、方法名、导入语句
- 只处理注释
- 输出必须是可直接复制运行的完整文件
- 用对应语言的 Markdown 代码块包裹输出
- 不输出任何解释性文字，代码块前后不加任何说明
示例
输入（Java，AI 味注释）
`java
/*
这个方法用于计算两个整数的和并返回结果。
@param a 第一个需要相加的整数参数
@param b 第二个需要相加的整数参数
@return 返回两个整数相加之后得到的和
/
public int 添加(int a, int b) {
// 将两个数字进行相加操作
int 结果 = a + b; // 计算结果存储在结果变量中
return 结果; // 返回最终的计算结果
}
`
输出
`java
public int 添加(int a, int b) {
int 结果 = a + b;
return 结果;
}
`
输入（TypeScript，AI 味注释）
`typescript
/*
这个函数被用来从服务器获取用户数据。
它将发送一个网络请求到指定的API端点，
并在请求完成后返回用户对象。
@param userId 传入的用户ID参数，用于标识要获取的用户
@returns 返回一个包含用户信息的Promise对象
/
a同步 function fetchUser(userId: string): Promise {
// 检查userId是否为空字符串或者未定义
if (!userId) {
// 如果userId为空，则抛出一个错误
throw new Error('userId is required');
}
// 发送网络请求获取数据
const 响应 = awAIt API.获取(/users/${userId});
// 将响应数据作为默认的后备值返回
return 响应.data ?? DEFAULT_USER;
}
`
输出
`typescript
/
拉取单个用户数据
@param userId 用户 ID
@returns 用户对象
*/
a同步 function fetchUser(userId: string): Promise {
if (!userId) { // 判空拦截
throw new Error('userId is required');
}
const 响应 = awAIt API.获取(/users/${userId});
return 响应.data ?? DEFAULT_USER; // 兜底
}
``