SuperAPI AI 工具集

setup-rules

编程与开发

查看项目

更新于 10-16 01:15

技能介绍

用途:把 Argo 的通用规则模板物化到当前项目,并按仓库实际结构做适配,再接入 CLAUDE.md/AGENTS.md,使智能体加载这些规则。核心原则为“适配而非倾倒”:引用项目中不存在路径或工具的规则属于冗余,每条安装规则的路径都必须能在仓库中解析到真实对象;若某规则主题在当前项目尚不存在,则不安装并记为延后。

主要能力:模板位于该技能自身的 rules/ 目录(相对 SKILL.md 解析),分两层。核心规则在任何语言下都安装,涉及工程原则(SOLID/DRY/KISS、薄处理器、计算位置、API 要落地)、代码风格(守卫子句、参数与行数上限、命名、边界校验)、注释纪律、文件结构(领域文件夹、公共入口、提升层级、分层)、领域类型(原始类型偏执、非法状态不可表示、概念单一归属)。条件规则在主题存在时才安装:testing.md(有测试运行器)、dependencies.md(有包管理器)、database.md(项目自有 schema:迁移目录、ORM/schema 文件或自维护查询层)、ui-components.md(有 UI 组件树)、design-system.md(有设计令牌层,任何形式)、designs.md(有原型/研究目录或设计工具配置且 UI 即产品界面)。绑定层按实际存在的语言安装,仅附带 typescript-style.md;其他语言在安装时依据核心规则与该语言工具链现场生成 <language>-style.md,必须逐行对照已安装工具链核实,不能凭记忆写。

使用方式:技能引导安装者先定位模板,再检测项目结构——按扩展名统计源文件语言、识别包管理器/构建工具及其清单与锁文件、确定公共入口机制、应用路径、源根、组件目录、令牌层、分层目录、schema 归属、既有命名约定,以及注释是否会被渲染到读者可见的页面(本仓库内命令生成或发布后由注册表呈现),然后替换全部 {{TOKEN}} 占位符,并仅写入已核实的内容。

适用场景与限制:适合希望在多语言、多栈项目中统一工程规则并让智能体自动加载规则的仓库。限制包括:模板以通用文本形式提供,具体路径与命令需按项目检测;ui-components.md 针对 TypeScript Web 树(Storybook、DOM、CSS 类),其他 UI 栈需重写而非裁剪;database.md 仅在自有 schema 时安装;testing.md 仅在存在运行器时安装;无法核实的内容应省略并报告,不得编造。资料未提供安装命令、收费与价格、平台支持或效果数据。