26 lines
1.6 KiB
Markdown
26 lines
1.6 KiB
Markdown
---
|
|
name: guidance-edit
|
|
description: 建立、检查或维护当前项目 .craftkit/standards/ 的规范索引，并安全接入用户确认的新规范。适用于修复索引、检查规范可达性和新增项目规则；只读规范查询、项目初始化或从代码自动推断强制规则不应触发。
|
|
---
|
|
|
|
# 项目规范维护
|
|
|
|
维护当前项目自己的增量规范，使 `guidance` 能从 `.craftkit/standards/index.md` 渐进检索到规则正文。不要附带、复制或补全任何外部私有规范库。
|
|
|
|
## 选择模式
|
|
|
|
- 建立或重组索引：读取 [初始化索引](references/init.md)。
|
|
- 检查失效链接、未索引文件或循环引用：读取 [覆盖检查](references/check.md)。
|
|
- 接入用户提供或项目已有的新规范：读取 [接入规范](references/add.md)。
|
|
|
|
## 共同边界
|
|
|
|
1. 先完整读取现有索引、目标文件及适用的 `AGENTS.md`、`.craftkit/project.json`。
|
|
2. 检查默认只读；建立索引、修复引用和接入规范都必须先展示目标路径、差异与冲突，经用户确认后写入。
|
|
3. 尊重项目已有目录和主题，不强制创建固定层级；只在内容规模和检索路径确有需要时增加中间索引。
|
|
4. 项目规则只记录项目特有增量。通用建议继续由 `guidance` 的公共基线提供，不能冒充项目强制要求。
|
|
5. 代码中的单一样本、未验证惯例和参考项目做法不得直接提升为规范。
|
|
6. 不写入凭据、个人绝对路径、私有仓库认证地址或未经授权的第三方正文。
|
|
|
|
完成写入后重新运行覆盖检查，并用 `guidance` 验证一个真实查询能命中新增或修复的规则。
|