个人 Prompt 库最常见的存放处是：聊天收藏、备忘录、随手的 notes.md。它们的共同问题是------改了不知道哪版生效，分享只能截图，评审无从谈起 。当你已经用 Cursor 的 @ 引用文件，却还在私聊里复制提示词，说明资产形态错了：提示词应按代码治理。
本文把 Prompt 库迁到 AtomGit （或其他 Git 托管亦可，步骤同构）：目录、去密钥、PR、tag，以及在 Cursor 里 @ 验证。可与 10-01 模板仓、10-05 开源安全基线对照。
摘要
- 盘点去重：只迁真正常用的提示。
- 分类：Ask / Agent / Review 等目录。
- 去密钥 ：占位符 +
.env.example。 - 进仓评审：改提示要 PR 与前后对比。
- Cursor
@：路径稳定才能团队复用。 - 边界：提示 ≠ Rules 铁律。
结论 ：提示词也是代码------进仓、可 diff、可回滚、可
@。
结论卡
| 问题 | 建议 |
|---|---|
| 全部提示都迁吗？ | 先迁高频与可复用 |
| 如何防泄漏？ | 去密钥检查清单 |
| 如何防劣化？ | PR + 固定题前后比 |
| 如何用？ | Cursor @prompts/... |
| 与 Rules 关系？ | 提示按需；铁律进 Rules |
迁移六步
1. 盘点
导出收藏夹与笔记，按「近 30 天用过 / 未用过」切开。未用过进 archive/ 或不迁。
2. 分类
推荐最小分类：prompts/ask/、prompts/agent/、prompts/review/、examples/。一文一提示，文件名用动词：ask-design-review.md、agent-min-diff.md。
3. 去密钥
所有 Token、内网主机、真实客户名改为占位符。示例：
text
API_BASE={{API_BASE}}
TOKEN 勿写入本文件；使用环境变量 PROJECT_TOKEN4. 推仓
创建 AtomGit 仓库，写清许可证与 README「如何 @」。建议浅克隆说明与目录树。
5. 评审
PR 模板强制：动机、适用模式、固定测试题、变更前摘要、变更后摘要、安全自检。
6. 引用验证
在 Cursor 打开消费该库的项目（或把库作子模块/subtree），@prompts/ask/ask-design-review.md，确认回答结构按模板变化。
推荐仓布局
text
prompt-library/
README.md
LICENSE
prompts/
ask/
agent/
review/
examples/
before-after/
.gitignore
.env.example文件头建议 YAML：
yaml
---
id: ask-design-review
mode: ask
inputs: [目标, 约束, 相关文件]
outputs: [风险列表, 开放问题, 建议下一步]
safety: 无密钥；不要求出网
---布局稳定，团队才不会每周改 @ 路径。
提示词 PR 流
改提示 = 改默认行为。流程：
- 分支只改一条主提示（可附一例）。
- 固定测试题跑前后对比。
- 评审看：安全、范围、是否与 Rules 冲突。
- 合并后打 tag（如
prompts-2026.10.08），在团队频道通知路径。
没有前后对比的 PR 应打回------否则库会缓慢漂移成「谁都改过、谁都不信」。
在 Cursor 中通过 @ 引用
三种用法：
- 任务卡引用 ：
@prompts/agent/agent-min-diff.md+ 你的具体目标。 - 评审引用 ：Ask 模式
@prompts/ask/ask-design-review.md+@相关文件。 - 项目覆写 ：团队 fork 后在项目内保留
prompts/子集，避免整库噪声。
注意：@ 进上下文仍耗 Token。厚手册不要每次全挂；拆短文件，按任务挂一条。
与 Rules 的边界（必须写进 README）
| Rules | Prompt 库 | |
|---|---|---|
| 触发 | Always / glob / 手动 | 通常手动 @ |
| 长度 | 铁律宜短 | 可稍长但仍应拆分 |
| 变更 | 影响面广 | 可按条 PR |
| 失败模式 | 广播税、冲突 | 路径漂移、未评审劣化 |
一句话：铁律进 Rules；可演练的话术进 Prompt 库。
版本化策略
main常绿可用。- 破坏性改版用 tag + CHANGELOG 一行。
- 消费者项目可钉到 tag（子模块指针）。
- 删除提示前先标
deprecated一到两周。
迁仓验收清单
- 克隆后 README 能找到 3 条常用提示路径。
- 仓内无真实 Token / 内网地址。
- Cursor 中
@prompts/...能改变回答结构。 - 至少 1 次 PR 带前后对比。
- README 写清：提示 ≠ 铁律。
案例：把「排障四步」从备忘录迁走
原文在备忘录里互相拷贝，三人三版。迁仓后固定为 prompts/agent/debug-four-steps.md，站会模板 @ 同一文件。两周后排障话术差异下降------这是版本化的收益，不是文笔更好。
踩坑
- 把整本 Wiki 塞进一个 prompt 文件。
- 提交个人 API Key「图省事」。
- 不写 mode 字段，Ask/Agent 混用。
- 路径天天重构，团队
@失效。
FAQ
Q：必须 AtomGit 吗？
A：不必；要的是 Git 托管 + 可被国内同事稳定克隆。AtomGit 对秋季活动友好。
Q：能否自动同步到 Rules？
A：不建议自动。提示与铁律变更节奏不同，自动同步极易制造冲突。
Q：私有提示怎么办？
A：私有仓或 private/ 不发布；公开仓只放可示范模板。
今晚可执行
- 挑 5 条高频提示建目录。
- 去密钥后推 AtomGit。
- 在 Cursor
@一条并截图留作 examples。 - 写下一次改提示必须走 PR 的约定。
可复制提示词块
把关键约束写成可粘贴块，减少每次临场发挥：
text
【模式】按任务选择 Ask / Agent / Manual
【目标】一句话可测结果
【允许路径】...
【禁止】密钥、出网、无关重构、改测试骗绿
【验收命令】...
【交付】diff --stat + 命令输出 + 风险一句提示词块应进 Prompt 库或团队模板，而不是散落在聊天记录。变更时走评审，避免「口头最新版」。
验证与回滚
任何实战步骤都要回答两问：怎么知道成功？失败如何回滚？成功标准尽量是命令退出码或明确文件存在性；回滚尽量是 git checkout / git revert / 关掉某 MCP 分组。把回滚写进任务卡，Agent 较少在恐慌中扩大爆炸半径。
建议在文末「今晚可执行」里强制包含一次回滚演练：故意改错再撤回来，确认肌肉记忆。
与 Token、权限的交叉约束
实战文若只教「怎么做」，不提成本与权限，读者会在真实项目里付学费。固定提醒：
- 上下文只挂本任务需要的文件与提示。
- 写与出网工具默认关，用时再开。
- 新会话交接用手写摘要，不靠无限滚动历史。
- 密钥只走环境变量，示例仓走检查清单。
这些句子可以重复出现在多篇实战里------重复的是纪律，不是车轱辘新闻。
团队落地差异
个人仓库可以激进试错；团队仓库要默认保守。落地时把「可选项」与「必选项」分开：必选项进公约与 CI，可选项进个人笔记。新人第一周只要求必选项达标（例如去密钥、diff 不越界、测试命令可复跑），避免被工具宇宙吓退。
若团队有 AtomGit / 内网 Git，把模板仓作为唯一入口，比每人自行拼装更少分叉。
失败案例复盘模板
text
日期：
任务目标：
使用的模式与模型（如可知）：
失败类型（卡住/乱改/漏测/权限/密钥）：
关键 diff 或日志：
根因（规则冲突/上下文脏/范围不清/...）：
规则或模板改动：
预防措施负责人与到期日：两周一次把复盘模板过一遍，实战文章里的清单才会进化；否则清单会停在「写的时候很对，用的时候没人翻」。
度量：什么叫变好了
可选取的轻量指标（不必上复杂平台）：
- 越界文件次数 / 周
- 排障新会话次数 / 周（止损是否变快）
- 红测先行任务占比
- 示例仓密钥扫描告警数
- 站会是否人人能出示
--stat摘要
指标用于改进模板，而不是考核惩罚。惩罚会逼人隐藏近失，这与安全目标相反。
文件命名与检索约定
- 使用
动词-对象：ask-design-review.md、agent-min-diff.md。 - 禁止空格与中文文件名（降低跨系统
@摩擦）。 - 每个文件头 YAML 含
mode/inputs/outputs/safety。 examples/before-after/只放脱敏后的对比，不放客户数据。
检索靠目录与文件名，先不要上复杂搜索服务。库小于一百条时，约定比工具重要。
消费者项目的三种接入
- 子模块钉 tag：适合多仓共用。
- 稀疏 checkout / 复制子集：适合只要 Ask 模板。
- 文档链到原始路径：适合暂时只读参考。
无论哪种，README 都要写「如何升级到新 tag」与「破坏性变更公告渠道」。
安全评审要点（PR 必看）
评审者不只看文采，要问：是否诱导出网？是否索要粘贴密钥？是否与 Rules L0 冲突？是否把未授权数据当训练示例？任一项命中则打回。
废弃与替换策略
提示词废弃时：文件头加 deprecated: true 与替代路径；保留至少两个发版周期再删；消费者项目的 @ 路径在 CHANGELOG 列出。突然删文件会造成全员会话断裂，版本化的意义就落空。
执行证据清单
- 迁仓 PR 链接，以及
prompts/目录树截图。 - 密钥扫描命令的输出（无真实 Token / 内网地址）。
- 一次 Cursor 中
@prompts/...前后回答结构的对比记录。 - 打下的版本 tag 与 CHANGELOG 条目。
边界
- 不提供绕过平台安全策略的提示。
- 活动规则以 AtomGit 官方说明为准。
提示词离开收藏夹的那一刻，才开始具备工程寿命。