75 lines
3.6 KiB
Markdown
75 lines
3.6 KiB
Markdown
# 卡若AI 使用手册 · 对话沉淀与优化规则
|
||
|
||
> **强制**：每次对话结束后，除完成「复盘」外，须按本规则做**沉淀**与**使用手册优化**（若有适用项）。
|
||
> **版本**：1.0 | **更新**：2026-03-01
|
||
|
||
---
|
||
|
||
## 一、适用范围
|
||
|
||
- **所有**在卡若AI 工作台内完成的对话（Cursor、API 等）。
|
||
- **每次对话收尾**：先完成「强制复盘」（见 `运营中枢/参考资料/卡若复盘格式_固定规则.md`），再执行本规则中的沉淀与手册优化。
|
||
|
||
---
|
||
|
||
## 二、对话后沉淀（必做项）
|
||
|
||
### 2.1 经验沉淀
|
||
|
||
若本次对话中有**可复用经验**（新踩坑、新解法、配置要点、与某 Skill 相关的实操结论等）：
|
||
|
||
1. **写入**：`02_卡人（水）/水溪_整理归档/经验库/待沉淀/`
|
||
2. **命名**：`YYYY-MM-DD_主题或技能名_简短描述.md`
|
||
3. **内容建议**：问题背景、做法、结果、适用场景、相关 Skill 或文档路径。
|
||
|
||
### 2.2 技能与注册表更新
|
||
|
||
若本次对话中**新增了技能**或**变更了某技能**（触发词、路径、能力描述）：
|
||
|
||
1. **SKILL_REGISTRY.md**：新增或修改对应技能行（触发词、路径、一句话）。
|
||
2. **对应 SKILL.md**：新增则新建并写全；变更则修改步骤、用法、注意点。
|
||
3. **技能控制台**（若有）：按 `运营中枢/工作台/01_技能控制台.md` 做配置/登记。
|
||
|
||
---
|
||
|
||
## 三、使用手册优化（有条件执行）
|
||
|
||
在**同一轮对话收尾**或**后续一次专门维护**中，按下列情况更新《卡若AI使用手册》：
|
||
|
||
| 情况 | 动作 |
|
||
|:---|:---|
|
||
| 新增了技能 | 在手册第二～六章对应组的表格中**新增一行**（技能、触发词、一句话、小节说明）；附录「手册更新记录」追加一行。 |
|
||
| 某技能触发词/职责变更 | 在手册对应章节表格中**修改该行**；必要时改「小节说明」；附录追加更新记录。 |
|
||
| 新增了板块或负责人 | 在「一、总览与入口」与对应新章中**补充**；附录追加更新记录。 |
|
||
| 运营中枢新增/变更规范或文档 | 在「七、运营中枢与规范」中**补充或修改**；附录追加更新记录。 |
|
||
| 本次对话产出了手册某节的更准确描述 | 直接**替换**该节「小节说明」或相关段落；附录追加更新记录。 |
|
||
|
||
### 3.1 手册文件位置
|
||
|
||
- **主手册**：`运营中枢/使用手册/卡若AI使用手册.md`
|
||
- **本规则**：`运营中枢/使用手册/对话沉淀与优化规则.md`
|
||
|
||
### 3.2 附录更新记录格式
|
||
|
||
在手册文末「附录 · 手册更新记录」表格中追加：
|
||
|
||
```text
|
||
| YYYY-MM-DD | 变更说明（如：新增 xx 技能；更新第 x 章 xx 小节）。 |
|
||
```
|
||
|
||
---
|
||
|
||
## 四、流程小结（每次对话结尾检查）
|
||
|
||
1. **复盘**：已按 `运营中枢/参考资料/卡若复盘格式_固定规则.md` 输出完整复盘块。
|
||
2. **沉淀**：若有可复用经验 → 已写入 `经验库/待沉淀/`；若涉及技能新增/变更 → 已更新 SKILL_REGISTRY 与对应 SKILL.md。
|
||
3. **手册**：若有技能/板块/规范新增或变更，或手册某节需更正 → 已更新 `运营中枢/使用手册/卡若AI使用手册.md` 对应处并追加附录更新记录。
|
||
4. **Gitea**：若有文件变更 → 执行 `bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/自动同步.sh`（单文件 >20MB 不提交）。
|
||
|
||
---
|
||
|
||
## 五、与 BOOTSTRAP / 总索引 的衔接
|
||
|
||
- **标准命令**（BOOTSTRAP 第六节）已包含「沉淀」；本规则把「使用手册优化」与「每次对话」明确绑定。
|
||
- **总索引** 中已增加「使用手册」入口，便于任何 AI 或用户找到手册与本规则。
|