CraftKit/plugins/skill/skills/guidance-edit/SKILL.md

name, description

name	description
guidance-edit	建立、检查或维护当前项目 .craftkit/standards/ 的规范索引，并安全接入用户确认的新规范。适用于修复索引、检查规范可达性和新增项目规则；只读规范查询、项目初始化或从代码自动推断强制规则不应触发。

项目规范维护

维护当前项目自己的增量规范，使 guidance 能从 .craftkit/standards/index.md 渐进检索到规则正文。不要附带、复制或补全任何外部私有规范库。

选择模式

• 建立或重组索引：读取 初始化索引。
• 检查失效链接、未索引文件或循环引用：读取 覆盖检查。
• 接入用户提供或项目已有的新规范：读取 接入规范。

共同边界

1. 先完整读取现有索引、目标文件及适用的 AGENTS.md、.craftkit/project.json。
2. 检查默认只读；建立索引、修复引用和接入规范都必须先展示目标路径、差异与冲突，经用户确认后写入。
3. 尊重项目已有目录和主题，不强制创建固定层级；只在内容规模和检索路径确有需要时增加中间索引。
4. 项目规则只记录项目特有增量。通用建议继续由 guidance 的公共基线提供，不能冒充项目强制要求。
5. 代码中的单一样本、未验证惯例和参考项目做法不得直接提升为规范。
6. 不写入凭据、个人绝对路径、私有仓库认证地址或未经授权的第三方正文。

完成写入后重新运行覆盖检查，并用 guidance 验证一个真实查询能命中新增或修复的规则。