메뉴
注释质量检查。检测 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
- 当前：`...`
- 判断：真违规 / 误报
- 修复：删除 / 保留 / 改写为 `...`