用途:Scaffold Rules 用于为 AI 编码智能体环境搭建共享开发规则。当用户想设置开发规则或编码约定、配置 AI 编码智能体环境,或为 Claude、Cursor 等智能体添加项目指南时使用。
主要能力:把规则直接写入 AGENTS.md 的标记区间内,并可在 CLAUDE.md 中补充 @AGENTS.md 引用。处理逻辑为:没有 AGENTS.md 时创建含规则区块的文件;存在 AGENTS.md 但无标记时,追加带标记的规则区块;已有标记时替换标记之间的内容,保留标记外的用户内容;若 CLAUDE.md 存在且尚无引用,则添加 @AGENTS.md。
使用方式:先可选预览,运行 bunx @plaited/development-skills scaffold-rules --dry-run,查看 actions 数组了解将创建哪些内容;再执行 bunx @plaited/development-skills scaffold-rules 完成脚手架;最后根据 actions 输出向用户说明创建了什么。CLI 选项包括 --list、-l 列出可用规则而不执行脚手架,以及 --dry-run、-n 预览操作而不做更改。
限制与注意事项:不要手动编辑 PLAITED-RULES-START 与 PLAITED-RULES-END 标记之间的内容,下一次运行会被覆盖。若规则在 AGENTS.md 中重复,通常是标记被手动删除,需移除重复区块后重新运行。若更新未生效,可能只存在一个标记,应确保起止两个标记同时存在,或删除两者以全新追加。若 @AGENTS.md 未加入 CLAUDE.md,通常是 CLAUDE.md 不存在,需先创建再重新运行。相关技能为 validate-skill,用于按 AgentSkills 规范校验技能目录。
适用场景:需要为团队或个人 AI 编码智能体统一编码约定、集中维护项目规则文件,并希望规则可在多次运行中安全更新而不影响用户自有内容的场景。