会话规范沉淀

这个 skill 帮助用户从当前会话中提取值得长期保留的规范、约束和偏好，并将其写入规范文件以便未来会话遵守。

核心原则

1. 只提取长期规范：区分"一次性任务细节"和"可复用的规则"
2. 用户主导：所有提取和写入都需要用户确认
3. 保护现有内容：追加而非覆盖，避免破坏原有结构
4. 语义对齐：确保规范在不同平台间保持一致的含义

工作流程

第 1 步：提取候选规范

从当前会话的完整历史中识别可沉淀的规范。重点关注：

应该提取的内容：

• 用户明确表达的偏好（"我不喜欢..."、"以后都..."）
• 反复纠正的行为模式（用户多次说"不对，应该..."）
• 明确的工作流程要求（"先做 A 再做 B"）
• 代码风格约定（命名规范、格式要求）
• 文件组织规则（目录结构、文件命名）
• 技术栈约束（"只用 X 库，不用 Y 库"）
• 输出格式要求（API 响应格式、文档结构）
• 协作方式偏好（"不要问我，直接做"、"每步都要确认"）
• 明确的禁忌事项（"永远不要..."、"禁止..."）

不应该提取的内容：

• 一次性任务的具体细节（"把这个文件改成..."）
• 临时的上下文信息（"我现在在调试..."）
• 偶发的讨论内容（没有形成明确结论的探讨）
• 已经在代码或文档中体现的内容（不需要重复记录）

提取方法：

1. 回顾整个会话历史，不要只看最近几条消息
2. 识别用户的重复模式和明确表态
3. 将每条规范提炼为简短、可执行的语句
4. 按类别分组（如果有多条），但保持连续编号

展示格式：

我从会话中提取到以下可沉淀的规范：

1. [简短描述] - 具体内容
2. [简短描述] - 具体内容
3. [简短描述] - 具体内容

请告诉我：
- 保留哪些（可以说"保留 1, 3"或"全部保留"）
- 删除哪些（可以说"删除 2"）
- 需要修改哪些（可以说"把 1 改成..."）

暂停并等待用户反馈。不要继续下一步。

第 2 步：确认最终规范

根据用户的反馈整理最终保留的规范：

1. 处理用户的自然语言指令（"保留 1 和 3"、"2 不要"、"把第一条改成..."）
2. 应用所有修改和删除
3. 展示最终版本：

最终待写入的规范：

1. [规范内容]
2. [规范内容]

确认无误后，我将询问写入范围。

等待用户确认。如果用户要求修改，返回重新调整。

第 3 步：询问写入范围

在用户确认规范内容后，询问写入位置：

这些规范应该写入：
1. 当前项目级规范（仅对当前项目生效）
2. 全局规范（对所有项目生效）
3. 两者都要

请选择 1、2 或 3。

等待用户选择。不要跳过这一步。

第 4 步：处理项目级规范

如果用户选择项目级（选项 1 或 3）：

1. 识别当前项目目录：使用当前工作目录
2. 定位规范文件：查找 CLAUDE.md（当前在 Claude 环境）
3. 读取现有内容：

```

Read /CLAUDE.md

```

如果文件不存在，准备创建最小可用文件

1. 分析现有结构：
• 识别已有的章节组织
• 检查是否有重复或冲突的规范
• 确定新规范应该放在哪个章节

1. 追加规范：
• 如果有合适的现有章节，追加到该章节
• 如果没有，创建新章节（如"## 代码风格"、"## 工作流程"）
• 保持与现有内容的风格一致（列表格式、语言风格）
• 避免机械重复：如果已有相似规范，考虑合并改写

1. 展示变更：

```

我将在项目级 CLAUDE.md 中追加以下内容：

[展示将要添加的文本及其位置]

确认后执行写入。

```

等待用户确认后执行写入。

第 5 步：处理全局级规范

如果用户选择全局级（选项 2 或 3）：

1. 定位全局文件：~/.claude/CLAUDE.md
2. 展示写入目标：

```

我将把规范追加到全局文件：

~/.claude/CLAUDE.md

这将影响所有项目。确认继续？

```

1. 等待用户确认

1. 读取并追加（方法同项目级）：
• 读取现有内容
• 分析结构，避免重复
• 追加到合适位置
• 保持风格一致

1. 展示变更并确认

第 6 步：差异检查与同步建议

在完成写入后，检查是否存在平台间的规范差异：

1. 读取两个平台的规范文件：
• Claude: ~/.claude/CLAUDE.md 或 /CLAUDE.md
• Codex: ~/.codex/AGENTS.md 或 /AGENTS.md

1. 分析差异：
• 哪些约束只存在于某一侧
• 哪些约束语义接近但表达不同
• 哪些内容可能需要同步

1. 如果有差异：

```

我发现 Claude 和 Codex 的规范文件存在差异：

[摘要说明差异内容]

是否需要我展示详细差异，以便您决定是否同步？

```

1. 如果用户同意：
• 展示具体的差异内容
• 询问是否要同步到另一个文件
• 如果同意，执行同步（遵循相同的读取-分析-追加流程）

1. 如果没有差异或用户不需要同步：

```

规范已成功写入。任务完成。

```

写入规范的要求

文件操作原则

1. 永远先读后写：在修改任何文件前，必须先读取其完整内容
2. 追加而非覆盖：使用 Edit 工具在合适位置插入，不要用 Write 覆盖整个文件
3. 保护用户内容：不删除、不改写与本次无关的内容
4. 创建最小文件：如果文件不存在，只创建必要的结构和新增规范

内容组织原则

1. 章节归位：
• 代码风格 → "## 代码风格" 或 "## Code Style"
• 工作流程 → "## 工作流程" 或 "## Workflow"
• 文件约定 → "## 文件组织" 或 "## File Organization"
• 技术栈 → "## 技术选型" 或 "## Tech Stack"
• 如果没有合适章节，创建简洁的新章节

1. 避免重复：
• 检查是否已有相同或相似的规范
• 如果有，考虑合并或增强现有规范，而不是添加重复项

1. 保持风格：
• 匹配现有文档的语言（中文/英文）
• 匹配现有的列表格式（- / 1. / *）
• 匹配现有的语气（命令式/建议式）

平台适配

虽然当前在 Claude 环境，但要为未来的 Codex 同步做准备：

• Claude 文件：CLAUDE.md（项目级）或 ~/.claude/CLAUDE.md（全局级）
• Codex 文件：AGENTS.md（项目级）或 ~/.codex/AGENTS.md（全局级）

两个文件的规范应该语义对齐，但不要求字面完全一致。

边界情况处理

会话中没有明显规范

如果会话中没有明显的可沉淀规范，仍然尝试提取一些可能的候选项：

我在会话中找到了一些可能值得沉淀的内容，但不太确定：

1. [候选项] - 置信度：中
2. [候选项] - 置信度：低

这些是否值得记录？或者当前会话确实没有需要沉淀的规范？

让用户来判断，而不是直接说"没有发现规范"。

文件不存在

如果规范文件不存在，自动创建最小可用文件：

# 项目规范

## [合适的章节名]

- [新增的规范]

不要生成冗长的模板或示例内容。

规范冲突

如果新规范与现有规范冲突：

我发现新规范与现有规范存在冲突：

现有：[旧规范]
新增：[新规范]

请选择：
1. 保留旧规范，放弃新规范
2. 用新规范替换旧规范
3. 两者都保留（我会添加说明）

用户表达不清晰

如果用户的选择指令不清晰（如"那几个不要"），主动澄清：

您是指删除第 [X] 和第 [Y] 条吗？请明确告诉我要删除哪些编号。

交互要点

1. 分步确认：每个关键步骤都要等待用户确认，不要一次性完成所有操作
2. 自然语言支持：理解用户的口语化指令，不要求固定格式
3. 透明展示：在写入前展示将要添加的内容和位置
4. 错误恢复：如果用户说"不对"，回退到上一步重新处理

示例交互流程

用户：以后写代码不要自动加注释，我自己会加。还有配置文件都放 config/ 目录。

用户：把这些记下来

助手：我从会话中提取到以下可沉淀的规范：

1. 代码风格 - 不自动添加注释和文档字符串，由用户自行添加
2. 文件组织 - 所有配置文件统一放在 config/ 目录下

请告诉我：保留哪些、删除哪些、或需要修改哪些？

用户：全部保留

助手：最终待写入的规范：

1. 代码风格 - 不自动添加注释和文档字符串，由用户自行添加
2. 文件组织 - 所有配置文件统一放在 config/ 目录下

确认无误后，我将询问写入范围。

用户：确认

助手：这些规范应该写入：
1. 当前项目级规范（仅对当前项目生效）
2. 全局规范（对所有项目生效）
3. 两者都要

请选择 1、2 或 3。

用户：2

助手：我将把规范追加到全局文件：
~/.claude/CLAUDE.md

这将影响所有项目。确认继续？

用户：确认

助手：[读取文件，分析结构，追加内容]

我将在全局 CLAUDE.md 的 "## 代码风格" 章节追加：
- 不自动添加注释和文档字符串，由用户自行添加

并在 "## 文件组织" 章节追加：
- 所有配置文件统一放在 config/ 目录下

确认后执行写入。

用户：好

助手：[执行写入]

规范已成功写入 ~/.claude/CLAUDE.md。

我发现 Codex 的规范文件（~/.codex/AGENTS.md）中没有这些规范。是否需要我展示详细差异，以便您决定是否同步？

用户：不用了

助手：好的，任务完成。

注意事项

• 这个 skill 的价值在于帮助用户积累长期可复用的规范，不要把它变成"会话记录器"
• 提取规范时要有判断力：区分"用户的一次性指令"和"用户希望长期遵守的规则"
• 写入文件时要小心谨慎：宁可多确认一次，也不要破坏用户的现有配置
• 如果不确定某条内容是否应该沉淀，把它列为候选项并标注置信度，让用户决定