> For the complete documentation index, see [llms.txt](https://cc-code.rongyeliu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cc-code.rongyeliu.com/skills/experience-summary/skill.md).

# /cc-code:experience-summary — 项目级开发经验沉淀器

> 把「这次踩的坑」变成「下次的准出门槛」。 落点是**项目级** `.cc_code/references/`（跟随项目走，不进插件、不进全局）。

## ⛔ 五条铁律

1. **项目级唯一落点**：只写当前项目 `.cc_code/references/`，⛔ 禁写插件目录、全局 `~/.claude/`。
2. **命名规范**：`[角色]-[具体事件域]-references.md`
   * 角色小写：`architect` / `dev` / `qa` / `pm`
   * 事件域 = 技术或流程主题，kebab-case，不含日期
   * ✅ `architect-bull-redis-queue-references.md`
   * ❌ `arch-xp.md`（无事件域）❌ `20260807-bug-references.md`（含日期）
3. **内容精炼**：只写「设计/验收时应该怎么思考、怎么做」，⛔ 禁写溯源叙事、清理修复过程、流水账。
4. **按需读取**：必须登记 `.cc_code/references/INDEX.md`（按角色分组，一行式「何时读」），⛔ 禁要求角色每次全读。
5. **不越权**：⛔ 禁改 `active/` 任何状态文件（Agent.md 权限表、status.md 等）——references 是补充资料，不是状态机。唯一例外：主人当场明确要求把 INDEX 挂进 `Agent.md` 某角色 `[按需读]`，可代笔加一行。

## 执行流程

```
① 定位角色      本次经验归谁：architect / dev / qa / pm
② 提炼准则      从对话/踩坑中抽出「必答问题 + 设计准则」
                每条准则 = 一句话规则 + 一句话为什么
③ 主人过目      先输出草稿给主人看，确认后才落盘（禁先斩后奏）
④ 落盘          写 .cc_code/references/[角色]-[事件域]-references.md
⑤ 登记索引      更新 .cc_code/references/INDEX.md（无则新建）：
                | 文件 | 何时读 |
⑥ 挂载请示      若该角色 Agent.md 未挂 INDEX，请示主人是否加 [按需读] 行
```

## 文件模板

```markdown
# [角色] 事件域经验标题

> 何时读：一句话触发条件（如「设计异步队列/中间件时必读」）。
> 由 /cc-code:experience-summary 沉淀，索引见 INDEX.md。

## 必答 N 问（准出门槛）

1. 故障场景 A → 谁兜底？
2. 故障场景 B → 谁消费？
（答不出 → 方案不准进下一角色）

## 设计准则

- **加粗规则**：一句话解释为什么。
- ……
```

## 质量标准

* 全文 ≤ 30 行；读一遍 ≤ 2 分钟。
* 准则必须可执行（能据此否决一个方案），禁空泛口号（如「注意性能」）。
* 同一事件域已有文件 → 更新该文件，不开新文件。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cc-code.rongyeliu.com/skills/experience-summary/skill.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.