用途
Project Rules Architect 用于为项目生成或彻底重构一套 AI 编码代理指令文件。它解决的核心问题是:当有人要求“把所有规则都写出来,像资深开发者一样行动”时,往往得到十几个深度不一、互相矛盾、且未接入任何加载机制的文件,最终无人信任、无人维护。本技能的目标是产出一套代理真正会遵循的规则集,而不是被略过的风格指南。
主要能力
- 提供专业化规则模板库,涵盖通用、按领域、按技术三类,通过探测项目来选取,而非整体复制。
- 确保“一个事实只存一处”:跨领域规则只存在于一个模板中,其他文件按名称引用。
- 对可能冲突的规则集给出明确优先级排序,写在入口文件中,供其他文件引用。
- 区分“散文预算”与“门禁下限”:散文(理由、框架、示例、历史)是上限,优先删减;门禁(阈值、命令、退出码、禁用列表)是下限,永不删减。
- 支持四种工作模式:上下文脚手架(在技术栈确定前生成四个记忆文件)、引导(无既有规则时生成精简骨架)、整合(重组既有规则,不删减内容)、采纳(既有代码库,运行 existing-project-protocol.md 检测并保留或迁移约定)。
- 生成并接入目标工具的配置文件(如 opencode.json、.cursor/ 等)。
使用方式
该技能通常由规划技能(如 Forge 或任何拥有 .forge/ 目录的等效技能)调用,且是作为被调用方,自身不进行路由。调用时机有两种:
- 上下文脚手架:在项目开始时、技术栈尚未确定时调用,仅生成四个上下文文件,不生成任何规则。
- 规则集:在规划技能确定技术栈和项目内容后调用,生成 AGENTS.md 及规则文件,并接入目标。
两次调用相互独立,互不隐含。项目可以只有脚手架没有规则,也可以只有规则没有脚手架,两者都不是缺陷。
技能还要求:每次会话起草前阅读 references/research-summary.md;在整合既有规则、采纳项目约定或移植模式时阅读 references/postmortems.md。
适用场景
- 项目启动阶段,需要建立跨会话记忆结构。
- 技术栈确定后,需要生成一套代理可执行的规则集。
- 既有规则混乱、冗余、矛盾,需要重组去重。
- 既有代码库需要检测并采纳其实际约定,生成不与之冲突的规则。
- 从其他项目移植规则模式(注意:只移植模式,不移植具体内容)。
限制
- 不生成教程性散文;模型已从训练中知道的内容应删除。
- 规则文件不得引用本项目不存在的文件、库或工具(污染)。
- 生成的规则文件不得提及自身的源模板或配置文件。
- 在无作用域的目标上(如 OpenCode instructions glob、单独的 AGENTS.md),拆分文件不节省加载量,只能控制总量。
- 上下文脚手架不生成任何规则、阈值、命令或版本锁定;若包含则说明脚手架变成了第二套规则集。
- 四个记忆文件(AGENTS.md、SESSION_LOG.md、DECISIONS.md、LEARNINGS.md)在脚手架调用后,本技能和规划技能均不再写入,由代理维护。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。