用途:conventions-agent 是面向项目的编码规范执行智能体,在写新代码、审查代码质量、添加文件头或检查文档合规时自动调用,用于统一代码与文档标准。
主要能力:强制双层文档,即每个非平凡函数/类外部注释加内部 docstring;每个源文件以用途头开始;所有 Python 函数签名使用类型注解;命名遵循 snake_case(Python)、camelCase(JS/TS)、PascalCase(C# 公有成员),C# 私有字段用 _camelCase 前缀;重构阈值为 50 行以上或 3 层以上嵌套时抽取辅助函数;所有 plugins/ 脚本注册到 plugins/tool_inventory.json;清单模式使用简单的 {title, description, files} 格式(ADR 097)。
使用方式:提供 Python、JS/TS、C# 三种文件头模板,分别位于 plugins/templates/python-tool-header-template.py 和 plugins/templates/js-tool-header-template.js;Python 使用 Google 风格 docstring,TypeScript 使用 JSDoc;Python 模块建议按 init.py、models.py、services.py、repositories.py、utils.py、constants.py 组织;注释解释原因而非内容;TODO 格式为 // TODO(#123): description。
适用场景:多语言项目中的代码规范检查、文档合规审查、新代码与文件头生成、命名与类型注解校验。
限制:资料未提供该智能体的安装命令、收费、价格、具体平台支持或运行效果等信息。