SuperAPI AI 工具集

chous

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

Chous 面向包含较大前端代码树的 .NET 仓库,用于文件结构层面的 lint 与目录策略约束。当仓库前端目录不断膨胀,且用户关注命名规范、文件夹结构或文件放置规则时可考虑使用;也适合对 ClientApp/、src/、apps/、packages/ 等目录强制布局策略,或前端文件树架构漂移比语法错误更严重的情形。不适用于语义代码缺陷、类型错误、框架 API 误用,也不用于文件内部 CSS、HTML、JS 规则的强制,仓库过小时引入结构检查反而增加额外负担。

输入包括最近的 AGENTS.md、package.json、已有的 .chous 文件以及需要策略约束的前端目录树。使用前先明确结构问题,例如命名规范漂移、组件放置、禁用文件夹或文件、monorepo 前端边界。可从 chous init 或已知预设开始,然后只收紧该仓库能解释清楚的规则,并保持签入的 .chous 文件可读。可添加可重复命令,例如 npx chous。应排除生成目录、构建产物和第三方资源,使信号聚焦架构层面。Chous 应作为语义 linter 的补充而非替代。移动或重构后应重新运行,确认结构策略仍符合设计意图。

缺失时可先检测现状,例如 rg --files -g 'package.json' -g '.chous' 与 rg -n '"chous"' --glob 'package.json' .;再使用官方免安装或全局方式 npx chous 或 npm install -g chous;确实需要结构策略时运行 npx chous init,并把可重复命令加入 AGENTS.md 与 package.json,随后用 npx chous 验证。结果状态可为 configured(已有签入的结构检查基线)或 improved(收紧了已有基线),仓库过小或变化过快时可返回 not_applicable。若首次运行标记过多文件,通常说明规则对当前成熟度过严,应从预设开始逐步收紧;生成或第三方目录应排除而非反复在评审中忽略;如果贡献者无法解释某规则保护什么,应先简化 .chous 策略再接入 CI。交付物为签入的前端结构策略、可重复的文件树检查命令,以及对生成与第三方目录的明确排除。验证要点是规则反映真实架构意图、排除生成输出、与语义 linter 并用且首次落地后仍可理解。收费、价格与平台支持等信息暂未提供。