SuperAPI AI 工具集

candid-validate-standards

通用与其它

查看项目

更新于 10-16 01:14

技能介绍

用途:分析 Technical.md 文件,找出在代码评审中可能无效、含糊或与现有工具重复的规则。

主要能力:定位 Technical.md(支持路径参数,或依次检查 ./Technical.md、./.candid/Technical.md);检测 ESLint/Prettier、Flake8/Ruff、golangci、RuboCop 等 linter 配置;解析列表项、编号项和 ## 标题下的规则;按六类问题校验:含糊用语(如 clean、proper、best practices)、缺少阈值(如 small functions、reasonable timeout)、与 linter 重叠(分号、引号、缩进、导入排序等)、多重关注点(含 and 或过长规则)、不可验证规则(如 be consistent)、代码库抽查(对引用路径或命名模式的规则,最多 10 条,检查文件是否存在并抽样 3 个文件验证)。

使用方式:运行该技能,可传入 Technical.md 路径;加 --fix 参数时输出具体改写建议。报告按严重程度分为 Critical、Warnings、Spot-Check、Good Rules,并给出汇总与建议操作。若未找到文件,提示用 /candid-init 创建。

适用场景:维护团队编码规范、减少评审中的主观争议、避免与 linter 重复、聚焦架构与安全等真正重要的规则。

限制:仅针对 Technical.md 文本规则;抽查最多 10 条规则、每条抽样 3 个文件;未提供具体阈值时需人工补充;不替代实际 linter 执行。