用途:校验每份API规范的info.description是否以祈使动词开头。它依赖智能体推理而非正则表达式,判断首词是否为适合描述API能力的真正祈使动词。适用场景:审查API描述的语气与风格一致性;发布前审计所有规范的描述质量;修复使用样板化或被动措辞的描述。主要能力:发现仓库根目录下所有api.yaml(跳过 .claude、scripts、docs、portal);读取info.description;评估首词是否为祈使动词、是否命中禁用的样板模式、内容是否至少20字符并传达API领域与能力;输出含API、状态、首词、问题的汇总表;对失败项给出以祈使动词开头的改写建议。良好示例开头如Manage、Query、Search、Deploy等;禁用模式包括Provides programmatic access to...、This is a RAML...、The X API allows you to...、This API...、API V1...、A set of endpoints for...、Enables users to...。限制:依赖智能体判断而非严格规则;资料未提供安装命令、具体调用方式、配置项与收费信息。
validate-imperative-format
编程与开发
更新于 10-16 01:31