chalkline

# 粉笔线 **在您的代理构建之前绘制一条线。** 粉笔线建立了一个您的代理可以实际使用的写作系统 — 在一次对话中。粉笔线是建筑工地上使用的第一种工具：只需弹一下，然后之后的每次切割都会直接完成。对于您的团队的语言来说，这就是它的作用。 ## 问题 您的代理现在正在编写 — 支持回复、产品文案、生命周期电子邮件、发行说明。他们对 *您的* 声音的了解仅限于提示中包含的内容。风格指南存在于 PDF 和维基中，但没有工具会参考它们。跳过设置的团队会责怪工具无法输出正确的内容。 ## 这是什么 一个模板仓库加上一个对话式设置协议。在任何 capable 代理（goose、Claude Code、Codex 或另一个 AGENTS.md-aware 托管）中打开您的副本，然后说： > **"设置我的写作系统。"** 代理会采访您， optionally 从您已经拥有的材料（风格指南、过去的活动、应用程序字符串）中学习，并生成一组小的参考文件 — **您的** 声音、**您的** 术语、**您的** 规则 — 任何代理都可以从中查询。从设置结束时开始，您的副本会重写并带有系统校验，批准的对保存为您的第一个校准检查。 无需安装 CLI。无需学习模式。无需手动编写规则，除非您想这样做。 ## 您将获得 ```text your-repo/ ├── AGENTS.md # 代理如何查询您的写作系统 ├── references/ │ ├── voice.md # 您如何听起来，附有真实示例 │ ├── terminology.md # 您使用的词语，您禁止的词语 │ └── channels.md # 每个频道的规则（仅当您需要时） └── calibration/ └── 001-….md # 批准的 before/after 对：校准检查 + 少量示例 ``` 两到四个小文件，加上一个校准对，而不是一百个。您控制生成的仓库及其可见性。仓库中的每个规则都得到了您的批准 — 每个文件都这样说，并带有设置印章的出处。按需增长，而不是提前。 ## 快速入门 1. **使用此模板**（GitHub → "使用此模板"）或克隆它。从私有仓库开始，除非所有输入和输出都安全发布。 2. 在您的代理中打开仓库。 3. 说 **"设置我的写作系统。"** 4. 回答问题。粘贴您有权限使用的材料；批准代理提取的内容。 5. 在您自己的副本中观看 before/after 演示 — 批准它，它将成为您的第一个校准对。 6. 检查差异，然后选择是否提交它。 目标时间：不到 30 分钟。我们正在通过实际设置体验来测试该目标。 在粘贴风格指南、客户文案或其他源材料之前，请阅读 [安全性和隐私](SAFETY.md)。Git 历史记录可以在您删除内容后保留内容。 ## 设置后 - 遵循 `AGENTS.md` 的代理在编写之前会查询您的参考资料 — 如果您的规则未涵盖某些内容，则会询问而不是猜测。 - 法律规定的确切措辞位于 **"确切措辞"** 标题下，代理被指示逐字节重现，而不是改述。 - 切换模型或托管？重新运行校准对。漂移可能会揭示参考资料的空白或模型或托管的差异 — 在客户发现之前发现其中任何一个都是值得的。 - 您可以将兼容的写作服务器或技能指向 `references/` 以跨工具检索。 - 随时重新运行设置以修订。批准的规则只有在您更改时才会更改；校准对是追加的。 ## 设计原则 1. **默认最小化。** 几个小文件比一大堆指南更好。复杂性由用户在需要时添加 — 绝不预先发货。 2. **您的规则，您的词语。** 代理起草；您批准。未经审查的内容不会进入您的系统 — 每个文件都带有其出处。 3. **立即证明。** 设置以存储库安全副本重写并带有您的系统而结束。批准的对作为校准检查保留。 4. **诚实的代理。** 没有编造的规则，没有静默解决的冲突，没有改述的法律措辞。当系统不知道时，它会说出来并询问。 5. **普通文件，无锁定。** Markdown 带有轻量级前置元数据。可由人类读取，可被任何工具使用，永久可移植。 ## 相关项目 [ai-rules](https://github.com/block/ai-rules) **分发** 已经存在的规则 — 一个代码指南的来源分发到 eleven 个代理的文件格式。粉笔线 **引出** 尚不存在的规则 — 生成您的第一个参考资料的对话。它们共享相同的约定（markdown 规则，轻量级前置元数据，AGENTS.md 路由）并自然组合：ai-rules 可以分发粉笔线生成的内容，MCP 写作服务器可以提供它。 ## 这不是什么 - 不是风格指南 — 它不提供关于您应该如何听起来的意见。 - 不是语法检查器或写作模型。 - 不是合规工具。它记录您的判断；它不提供它。 ## 贡献 该协议通过设置体验改进：人们停滞的地方，什么问题混淆了，生成的文档遗漏了什么。请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。 在 [Apache-2.0](LICENSE) 下许可 · 管理： [GOVERNANCE.md](GOVERNANCE.md)