القائمة
注释质量检查。检测 AI 废话注释、空 JSDoc、TODO 无编号、调试日志等。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Wails Binding 签名一致性。对比 Go 端导出函数 vs 前端 wailsjs。
问题排查记录搜索。按关键词查找 bug-chronicle.md 中的相关 bug。
构建与调试流程。Go 后端编译、前端 Vite 构建、完整 Wails 构建、测试。
项目结构扫描与 AGENTS.md 更新。扫描 Go 包和前端组件结构，输出文档地图更新建议。
项目健康诊断。一键检查 Go 编译、前端构建、文件完整性、治理红线、配置一致性。
事件注册审计。扫描 EventsOn/bus.on 注册位置是否合规。
| name | comment-checker |
| description | 注释质量检查。检测 AI 废话注释、空 JSDoc、TODO 无编号、调试日志等。 |
| runAs | subagent |
python3 scripts/comment-checker.py --json，获取结构化违规清单docs/comment-checker-report.md| 类型 | 真违规信号 | 误报信号 |
|---|---|---|
| AI 废话 | 注释重复代码逻辑（"用于获取列表"→getList()） | 注释解释了 WHY 而非 WHAT |
| 空 JSDoc | @param {string} path 无下文 | 有实质描述 |
| TODO 无编号 | TODO: 后续优化 无关联 | 有 #issue 或责任人 |
| 注释掉的代码 | // var old = ... 完整语句 | 临时注释掉的调试行 |
| 调试日志 | console.log(xxx) 裸调用 | [YSM] / [sync] 等业务日志 |
## [type] file:line
- 当前：`...`
- 判断：真违规 / 误报
- 修复：删除 / 保留 / 改写为 `...`