phpmac/solidity-comment-style
plugins/my-agents/skills/solidity-comment-style/SKILL.md
当用户要求 "清理 Solidity 注释", "精简合约注释", "规范代码注释", "提升可读性", "移除冗余注释", 或 "优化合约注释风格" 时应使用此技能
documentation
Updated Apr 18, 2026
$ install --global
skillsauthnpx skillsauth add phpmac/skills solidity-comment-styleInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 6:14 AM58.4s2 files scanned
SKILL.md
- name:
- solidity-comment-style
- description:
- 当用户要求 "清理 Solidity 注释", "精简合约注释", "规范代码注释", "提升可读性", "移除冗余注释", 或 "优化合约注释风格" 时应使用此技能
- allowed-tools:
- Read, Grep, Glob, Edit, Bash
Solidity 注释清理
精简 Solidity 合约中的冗余注释, 保留关键信息, 提升代码可读性.
核心原则
- 保留核心: @title, @dev, @param, @return 是标准文档, 保留
- 删除冗余: 详细步骤, 重复描述, 内部实现细节删除
- 业务优先: 复杂的数学计算, 安全警告, 业务逻辑保留
- 逐步清理: 分多次提交, 便于回滚
注释清理规则
删除的注释
| 类型 | 示例 |
|------|------|
| 详细步骤流程 | 1. 验证调用者 2. 转账 3. 更新状态 |
| 重复功能描述 | @dev 发送代币...发送代币给指定地址 |
| 事件参数说明 | @param amount 数量 (事件本身已自解释) |
| 简单构造函数 | @dev 构造函数 (无需说明) |
| 内部实现细节 | 长篇的调用链, 流程图说明 |
| 遗留注释 | 已删除代码的相关注释 |
保留的注释
| 类型 | 示例 |
|------|------|
| 合约级核心机制 | [核心机制] 采用 X 方案... |
| 复杂数学公式 | 涉及 K 计算, 价格公式等 |
| 函数一行描述 | @dev 转账 (带滑点保护) |
| 参数说明 | @param amount 转账数量 |
| 安全警告 | // 防止重入攻击 |
| 非显而易见逻辑 | 业务约束, 边界条件 |
执行流程
- 识别目标: 查找超过 10 行的函数注释
- 应用规则: 按清理规则精简
- 编译验证: 确保清理后代码能编译
- 输出报告: 列出修改的文件和行数
附加资源
清理前后对比示例详见 references/examples.md.
Related Skills
phpmac/linux-privesc
data-ai
VerifiedTrustedCommunity
当用户提到 Linux 提权/本地提权/local privilege escalation/获取root权限/内核漏洞利用/LPE/SUID/sudo滥用/容器逃逸/权限提升检测; 或要求在Linux系统上从普通用户提升到root权限; 或查询CVE提权漏洞(如Dirty Pipe/CopyFail/Dirty Frag/PwnKit/Looney Tunables); 或需要安全加固建议时应使用此技能
SKILL.mdUpdated May 11, 2026
phpmac/position-sizing
tools
VerifiedTrustedCommunity
当用户要求 "计算仓位", "仓位管理", "止损比例", "凯利公式", "盈亏比", "资金管理", "半凯利", "反马丁格尔", "固定风险", "position sizing", "策略评估", "策略体检", "SQN", "夏普比率", "卡玛比率", "期望值", "获利因子", "MAE", "MFE", "R乘数", "索提诺", "蒙特卡洛", "样本外测试", "策略回测" 或需要计算合约交易的最优仓位/止损/资金分配/策略质量评估时应使用此技能. 覆盖仓位管理/策略评估/交易解剖/压力测试的完整框架. 即使用户只是提到 "这笔交易该下多少", "策略好不好", "复盘怎么算" 等模糊描述也应触发.
SKILL.mdUpdated May 10, 2026
phpmac/apk-api-extractor
development
VerifiedTrustedCommunity
当用户要求 "提取API", "逆向APK", "分析APP接口", "提取业务端点", "React Native逆向", "Flutter逆向" 或需要从移动应用提取后端API信息时使用此技能. 覆盖APK解包/JS bundle分析/kernel_blob.bin分析/H5页面参数发现/Spring Boot API验证全流程. 支持React Native和Flutter两种框架.
SKILL.mdUpdated May 5, 2026
phpmac/vps-provider-researcher
research
VerifiedTrustedCommunity
当用户要求 "推荐VPS", "选服务器", "对比服务商", "建站VPS", "便宜VPS", "VPS推荐" 或需要研究/筛选/对比VPS服务商时应使用此技能. 从 hostloc/lowendtalk/lowendbox/测评站搜集真实评测数据, 交叉验证后给出可溯源排名.
SKILL.mdUpdated May 4, 2026