SuperAPI AI 工具集

coding-conventions-agent

编程与开发

查看项目

更新于 10-16 08:00

技能介绍

用途:该智能体负责为项目内所有代码强制统一编码规范与文档标准,在编写新代码、代码质量审查、添加文件头、检查文档合规性等场景自动触发。\n\n主要能力:要求双层文档(函数/类外部注释加内部 docstring)、每个源文件带用途头、Python 函数签名使用类型注解;命名规范按语言区分——Python 用 snake_case,JS/TS 用 camelCase,C# 公共成员用 PascalCase,C# 私有字段用 _camelCase 前缀;重构阈值为 50 行以上或 3 层以上嵌套需抽取辅助函数;所有插件脚本须注册到 plugins/tool_inventory.json;清单 schema 采用 {title, description, files} 格式(ADR 097)。\n\n使用方式:提供 Python、JS/TS 文件头模板及 Google 风格 docstring、JSDoc 示例;Python 模块按 init、models、services、repositories、utils、constants 组织。架构规则要求不通过 subprocess 或相对路径直接调用其他插件的脚本,也不使用指向插件根目录之外的物理符号链接,而应让对话智能体触发其他插件的技能(如 Please trigger the rlm-curator skill)。多技能脚本:单技能使用时放在所属技能目录下,多技能共用时提取到插件根目录并回链本地符号链接。提交前检查包括文件头、工具注册和工具清单审计无未跟踪脚本。TODO 格式为 // TODO(#123): description。\n\n适用场景与限制:适用于遵循该规范的多语言项目开发与审查。资料未提供收费、价格、平台支持或具体效果数据。