用途:该技能是一个编码规范执行智能体(The Standards Agent),用于确保整个代码库与 .agent/rules/ 中的策略保持一致,涵盖脚本与代码,目标是无脚本被豁免,新智能体可快速理解代码,且代码质量统一。其权威标准定义于 .agent/rules/coding-conventions.md 及相关策略文件。
主要能力:强制双层文档(外部注释+内部 docstring)、文件头、Python 类型注解、命名规范(Python 用 snake_case,JS/TS 用 camelCase,C# 公共成员用 PascalCase)、重构阈值(50 行以上或 3 层以上嵌套需提取辅助函数)、清单 schema(采用 {title, description, files} 格式,ADR 097)。还包含跨插件依赖规则(ADR-001,不得直接执行其他插件脚本或使用跨插件符号链接)与多技能脚本组织规则(ADR-002)。
必要用法:依赖 Python 3.8+,仅用标准库。安装依赖命令为 pip-compile ./requirements.in 与 pip install -r ./requirements.txt。检查工作区合规可运行:python3 plugins/dev-utils/scripts/workspace_conventions_auditor.py,该工具解析 Python AST 并正则匹配 JS/TS,报告位于 temp/workspace_conventions_report.md。
适用场景:编写或审查代码、补充文件头与文档、执行提交前检查时。
限制:资料未提供具体收费、平台支持范围与效果保证等信息。