用途:作为代码库模式分析技能,发现、验证并记录代码库中重复出现的约定,使新代码与既有实践保持一致。分析目标通过 $ARGUMENTS 传入,可为具体文件、目录/模块或整个代码库。
主要能力:按 NAMING(命名)、ARCHITECTURE(架构)、TESTING(测试)、ORGANIZATION(组织)、ERROR_HANDLING(错误处理)、CONFIGURATION(配置)分类识别模式,并给出置信度 HIGH/MEDIUM/LOW。每个模式记录名称、描述、至少两处 file:line 证据、置信度、是否已有文档记录。输出 PatternReport,含模式列表、冲突列表与对新建代码的建议。
工作流程:先按目标范围抽样,每类文件读取 3-5 个代表性文件,同类模块优先,并纳入风格指南、CONTRIBUTING.md、linter 配置;再逐类别扫描命名、架构、测试与组织模式;随后验证是否为有意约定(是否被文档或工具强制、出现频率、提交历史)并据此定置信度;再检测同类模式间的冲突并给出应遵循哪个及理由;最后输出报告。
约束:禁止仅凭单个文件出现就宣布为模式;必须提供 file:line 证据;须区分有意约定与偶然一致;即使既有模式不完美也应遵循一致性优先;测试代码同样要分析;冲突时优先推荐被修改区域所用的模式,若并列优先有工具强制的模式;不得假设其他项目的模式适用;引入新模式须说明偏离;不得忽略冲突。
适用场景:生成代码前、代码审查、重构或修改特定模块时,用于确认应遵循的既有约定。
限制:关于该技能的安装命令、支持平台、收费情况等资料暂未提供。