SuperAPI AI 工具集

convention

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

用途:把项目既有代码中的编码约定提取成 .claude/convention/ 下的文档,方便后续按范本编写新代码。

主要模式:full(默认,P0-P8 全流程)、conventions(提取规范与范本)、rules(提取规则,需已存在 .claude/convention/)、paths(按指定路径限定范围,如 src/a,src/b)。模式可从自然语言提示中解析,命令行参数为自由文本。

能力与流程:先探测技术栈(java/kotlin、typescript、python、rust、go 或未知),扫描项目文件;再按栈激活分析层,并行启动多个子代理分析各层;随后由 Plan 代理每层选出 1-2 个范本;再由写作者生成三份文档:reference-patterns.md、testing-conventions.md、project-architecture.md,各带固定 frontmatter(doc_type、version、generated_by、last_updated)。可选文本优化、用户复核、规则整理与更新 CLAUDE.md。

用法示例:/brewcode:convention、/brewcode:convention conventions、/brewcode:convention rules、/brewcode:convention paths src/a,src/b。脚本调用包括 detect-stack、scan、setup、validate 等子命令。

限制:规则模式需先运行 conventions 模式;源文件超过 1000 个会提示改用 paths 模式;无源文件或缺少约定目录时直接退出;未知栈走通用分析。具体版本号与日期由脚本解析,未在资料中给出具体数值。