SuperAPI AI 工具集

spec-rules-init

编程与开发

查看项目

更新于 10-15 16:51

技能介绍

spec-rules-init 属于 anyoneanderson/agent-skills,用途是从项目现有约定中提取规则,生成统一的 coding-rules.md,供后续实现与审查作为质量门禁使用。

主要能力:自动检测输入语言并保持同语言输出(日文输入用 references/rules-template.ja.md,英文输入用 references/rules-template.md,显式指定语言优先)。先执行初始上下文检查,如 pwd、ls -la,检测 CLAUDE.md、AGENTS.md、.claude/、package.json、go.mod、.eslintrc*、biome.json、tsconfig.json、.prettierrc* 及源码文件,并扫描 ~/.claude/skills//SKILL.md 与 .claude/skills//SKILL.md。随后按测试标准、代码质量、错误处理、文档、安全、Git 六类提取规则,标注 [MUST]、[SHOULD]、[MAY] 与来源文件和行号;CLAUDE.md / AGENTS.md 规则为优先级 1,默认 [MUST]。若无源码则跳过代码库分析。若存在源码,分析目录结构、文件命名惯例(某模式占比 60% 以上建议为 [MUST])、依赖库并给出库相关最佳实践 [SHOULD] 规则,并检测 utils/、helpers/、lib/、shared/、common/ 等共享模块,汇总到生成的 coding-rules.md 的 Shared Utilities 部分。之后按已安装技能与项目技术栈匹配,征求用户确认后以优先级 3 生成 [SHOULD] 或 [MAY] 规则;低优先级规则与高优先级冲突时保留高优先级并提示。

使用方式:可通过自然语言触发,如“Generate coding rules”“コーディングルールを生成して”“Create coding-rules.md --force”“Extract project rules --category testing”“Update coding-rules.md”。选项包括 --force(覆盖既有文件且不确认)、--category <name>(仅生成指定类别)、--with-review-rules(同时生成 review_rules.md 并跳过确认)、--no-review-rules(不生成 review_rules.md)。交互中会询问输出路径(默认 docs/coding-rules.md,可选 docs/development/coding-rules.md 或自定义)、补充缺失类别规则、是否为 Git 提交消息选语言、是否生成 review_rules.md 等。若已存在 coding-rules.md,会对比新增、变更与删除,供选择覆盖、仅合并差异或取消。生成后可选择在 AGENTS.md / CLAUDE.md 末尾追加引用;两者均不存在时跳过并警告。

输出为 coding-rules.md,可选附带 review_rules.md,含按类别的严重级别标签与来源摘要表。完成后会提示与 spec-generator、spec-inspect、spec-implement 等 spec-series 的集成关系;若生成 review_rules.md,还会提示 spec-workflow-init、cmux-second-opinion、GitHub Actions(如 claude-review.yml)可引用。

限制:无约定文件时退回仅对话模式;文件不可读则警告并跳过;输出目录不存在会自动创建;无写权限时报错并建议更换路径。用户资料未提供收费、价格、平台、效果等信息。