SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场fusion-rule-author

fusion-rule-author

编程与开发

查看项目

更新于 10-15 12:28

技能介绍

用途

fusion-rule-author 是一个内部支撑技能，为「编写 AI 编程助手规则」这件事提供规范化的工作流、模板和参考资料。它支持 GitHub Copilot、Cursor 和 Claude Code。该技能不直接面向用户：用户通过 fusion-rules 网关交互，网关再路由到特定编辑器的代理，由这些代理遵循本技能定义的工作流来执行。

主要能力

本技能提供三类内容：

  • 工作流（步骤 1–7）——引导式规则编写流程；
  • 模板（assets/）——各编辑器格式的起始文件；
  • 参考资料（references/）——技术栈示例。 它不提供代理；代理位于 fusion-rules/agents/ 中，并引用本技能的资产与工作流。

使用方式（工作流）

  1. 评估现状：检查仓库中已有的规则文件，包括 .github/copilot-instructions.md、.github/instructions/.instructions.md、.cursor/rules/.md 与 .mdc（含子目录）、CLAUDE.md、.claude/CLAUDE.md、.claude/rules/.md（含子目录），报告存在什么、缺少什么、是否需要更新或新建。
  2. 扫描仓库：在访谈前先从文档（README.md、CONTRIBUTING.md、AGENTS.md、CLAUDE.md、docs/adr/、docs//.md、SECURITY.md、CODE_OF_CONDUCT.md）、配置文件（package.json / pyproject.toml / .csproj、tsconfig.json / jsconfig.json、biome.json / .eslintrc / .prettierrc / ruff.toml / .editorconfig、.github/workflows/*.yml、Dockerfile / docker-compose.yml、Makefile / Justfile / Taskfile.yml）以及代码模式（入口点、测试文件、目录结构）中提取可执行的约定，并向开发者呈现按领域整理的发现摘要。跳过频繁变化的实现细节、重述语言/框架默认值的内容，以及未被 CI 或团队实践强制执行的「理想化」规则。
  3. 访谈补缺：仅针对扫描未覆盖的缺口提问，逐项覆盖技术栈、代码风格、架构、测试、文档、Git 工作流、安全、路径特定关注点；每个领域先呈现扫描结果再确认。对需要更多上下文的约定，使用 assets/creation-follow-up.md 中的追问。
  4. 分类指导：区分始终生效约定、作用域约定等，并按 GitHub Copilot（根 copilot-instructions.md 对所有交互生效；scoped instructions 仅在匹配文件打开/引用时生效）、Cursor（alwaysApply: true 的 .mdc 对每次会话生效；带 globs 的自动附加；仅带 description 的由代理选择；无 alwaysApply 无 globs 的手动 @ 提及）、Claude Code（CLAUDE.md 每次会话生效；带 paths frontmatter 的 .claude/rules/*.md 在读取匹配文件时生效；无 paths 则每次会话生效）分别给出目标文件与触发时机。若约定适用于仓库所有文件，放入根/始终生效指令；若仅适用于特定路径或文件类型，创建作用域规则。面向多个编辑器时生成内容等价的并行文件，不在同一编辑器内重复指导。
  5. 起草规则文件：使用 assets/ 中的模板（Copilot 根模板 copilot-instructions-template.md、作用域模板 scoped-rule-template.md 并设置正确的 applyTo glob；Cursor 使用 cursor-rule-template.mdc 并设置 frontmatter；Claude Code 使用 claude-rule-template.md，作用域规则放入 .claude/rules/ 并带 paths frontmatter）。质量要求：保持简洁、使用祈使语气、避免根与作用域文件重复、校验 glob 匹配、根指令超过约 80 行时警告（上下文稀释风险）、作用域文件超过约 50 行（Copilot）/约 500 行（Cursor）/约 200 行（Claude Code CLAUDE.md）时警告。
  6. 评审与修改：向开发者展示每个文件的完整内容、高亮质量警告（长度、过宽 glob、重复），征求批准或修改。
  7. 写入文件：批准后写入仓库，按需创建 .github/instructions/、.cursor/rules/、.claude/rules/ 目录；写入前确认最终文件清单与路径。

此外资料中给出「指令 vs 技能 vs 规则」的对照表：始终生效的编码约定分别用 copilot-instructions.md、带 alwaysApply: true 的 .cursor/rules/.mdc、CLAUDE.md；文件/路径特定指导用 .github/instructions/.instructions.md、带 globs 的 .cursor/rules/.mdc、带 paths 的 .claude/rules/.md；任务特定的多步工作流使用 Skill（SKILL.md）、Cursor 规则（手动或代理选择）、Skills/子代理；代理路由与编排使用代理定义（.agent.md）、带 description 的 .cursor/rules/*.mdc、子代理配置；简单的项目级指令使用 copilot-instructions.md、AGENTS.md、CLAUDE.md。指令与规则塑造 AI 如何写代码，技能定义它作为结构化任务能做什么。

预期输出

.github/copilot-instructions.md（创建或更新）；.github/instructions/.instructions.md（零个或多个作用域指令文件）；.cursor/rules/.mdc（面向 Cursor 时）；CLAUDE.md 或 .claude/CLAUDE.md（面向 Claude Code 时）；.claude/rules/*.md（零个或多个 Claude Code 作用域规则文件）；以及关于创建/更新了什么及原因的摘要。

限制与安全约束

绝不：在规则文件中嵌入密钥、令牌或凭据；生成与仓库安全策略相冲突的规则；未展示 diff 并获批准就覆盖已有文件；编造约定（只记录开发者确认的内容）。始终：写入前展示草稿；针对实际仓库路径校验 glob 模式；对过宽 glob（如 */ 捕获一切）发出警告；保持指令简洁可执行；更新时保留已有内容（追加或合并，绝不静默替换）。

参考文件

references/examples.md（不同技术栈的具体示例）、assets/creation-follow-up.md（逐规则追问：目的、例外、边界、语气）、assets/frontmatter-scenarios.md（面向三种编辑器的场景化 frontmatter 指南）、assets/copilot-instructions-template.md、assets/scoped-rule-template.md、assets/cursor-rule-template.mdc、assets/claude-rule-template.md、assets/quality-checklist.md。

暂未提供的信息

以上资料未说明本技能的收费方式、价格、平台支持范围、使用效果或具体安装命令，相关内容暂未提供。