菜单
手动或自动保存会话核心内容到 context 文件。 触发方式：用户输入 /save-context，或首次工具调用时自动触发。 保存位置：.ai/context.md（主文件/索引）+ .ai/context-YYYY-MM-DD.md（日期归档/详细内容） 核心功能：记录历史错误与经验教训，避免模型切换后重复犯错。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when performing code review, code review after changes, code formatting, editing code, modifying code, or when user asks to review code. Applies to all programming languages (Java, Python, Go, TypeScript, Vue, etc.). Checks: code specifications, class/method comments, comment ratio (≥60%), naming conventions, security rules, exception handling, logging standards, database specs, API design, git commit format, dependency management, code complexity limits, null safety, function parameters limit, code duplication detection, magic numbers/constants, collection capacity, string concatenation, equals/hashCode. Trigger automatically when user modifies or formats code.
Use when user wants to create a story line for business execution. This skill is DRIVEN by the Superpowers brainstorm skill. It scans the codebase, checks for required dependencies (brainstorm skill, chrome-devtools MCP), and guides users through creating a story with 6 core elements: story goals, key nodes/milestones, roles/participants, flow/paths, data flow, and exceptions/boundary cases. Each element is refined via brainstorm after user confirmation. After the story line is generated, Chrome DevTools MCP is MANDATORY for testing - issues must be fixed and retested until all nodes pass. Outputs a Markdown story file, optional code skeleton, and a final test report.
用于编写 API 接口文档。当用户需要编写、创建、格式化 API 接口文档时触发，包括描述 API 端点、Header 参数、Body 请求体、响应结果、使用示例等场景。适用于后端 API 文档编写、接口规范制定、API 文档模板生成等任务。
Use when working on DDD (Domain-Driven Design) architecture — bounded contexts, entities, value objects, aggregates, domain events, repositories, domain services, factories, CQRS, event sourcing. Trigger when user mentions DDD, domain modeling, strategic design, tactical design, CQRS, event sourcing, or asks about architectural patterns for complex business domains.
Use when AI generates code and code cleanup/formatting is needed - removes unused imports, sorts imports alphabetically, removes unused methods, and adds missing Javadoc comments
产品经理最佳实践 — 需求分析、产品规划、用户体验设计、数据驱动决策、A/B测试、敏捷实践、MVP思维。当用户讨论产品需求、用户故事、功能设计、用户体验、数据分析、业务指标、产品迭代，或询问产品决策时触发。
| name | save-context |
| description | 手动或自动保存会话核心内容到 context 文件。 触发方式：用户输入 /save-context，或首次工具调用时自动触发。 保存位置：.ai/context.md（主文件/索引）+ .ai/context-YYYY-MM-DD.md（日期归档/详细内容） 核心功能：记录历史错误与经验教训，避免模型切换后重复犯错。 |
| triggers | ["/save-context","自动检测：首次工具调用时保存项目结构"] |
手动或自动触发 skill，将会话核心内容保存到项目根目录 .ai/ 目录下的 context 文件中。
核心目的：当模型切换上下文后，重新开发新功能时不能重复已经犯过的错误。
文件分工：
.ai/context.md - 主文件，记录索引（归档文件路径），不重复详细内容.ai/context-YYYY-MM-DD.md - 日期归档文件，记录当日所有详细内容支持两种触发模式：
/save-context/save-contextsave-context skill 命令通过 PostToolUse Hook 实现：
.ai/.context-initialized 标记文件是否存在| 输入格式 | 触发方式 | 保存位置 |
|---|---|---|
/save-context | 手动 | .ai/context.md（索引）+ .ai/context-YYYY-MM-DD.md（详细内容） |
| 首次工具调用 | 自动 | .ai/context.md + .ai/context-YYYY-MM-DD.md |
// 检查 .ai/.context-initialized 是否存在
// 如不存在，说明是首次触发，需要保存项目结构
分析当前对话历史，识别核心内容：
读取项目背景
.ai/context.md（如存在）了解已有重点分析对话，识别核心内容
提炼核心要点
.ai 目录是否存在，不存在则创建.ai/context.md（主文件/索引）.ai/context-YYYY-MM-DD.md（日期归档/详细内容）如果文件不存在，创建新文件并写入标题：
# 项目重点
## 索引
### 历史错误记录
### 问题与解决方案
### 项目结构
## {日期}
日期归档文件 (.ai/context-YYYY-MM-DD.md) 写入详细内容：
# 项目重点 - {日期}
> 本文件为自动归档，保存当日所有重点内容
### 历史错误记录
- [Error][状态] 错误标题
- **错误现象**：具体表现，日志/错误信息
- **错误位置**：在哪个模块/文件/函数
- **RootCause** 根本原因：
- **Fix** 修复方法：
- **Lesson** 经验教训：
- **Avoid** 避免方法：
### 问题与解决方案
- [Question][状态] 问题标题
- **问题描述**：详细描述问题
- **Solution** 解决方案：
- **Result** 结果：✅/❌
### 关键决策
- [Decision] 决策内容及理由
主文件 (.ai/context.md) 写入索引（不重复内容）：
# 项目重点
## 索引
### 历史错误记录
- 详见 [.ai/context-YYYY-MM-DD.md](.ai/context-YYYY-MM-DD.md) - YYYY-MM-DD
### 问题与解决方案
- 详见 [.ai/context-YYYY-MM-DD.md](.ai/context-YYYY-MM-DD.md) - YYYY-MM-DD
## {日期}
### 项目结构
- {目录/文件结构概览}
### 架构决策
- [Architecture] {决策内容}
自动触发时，创建 .ai/.context-initialized 标记文件：
# Context 初始化标记
# 本文件用于标记项目结构已保存，防止重复保存
initialized: true
initialized_at: YYYY-MM-DD
# 项目重点
## 索引
### 历史错误记录
- 详见 [.ai/context-2026-04-03.md](.ai/context-2026-04-03.md) - 2026-04-03
### 问题与解决方案
- 详见 [.ai/context-2026-04-03.md](.ai/context-2026-04-03.md) - 2026-04-03
- 详见 [.ai/context-2026-04-01.md](.ai/context-2026-04-01.md) - 2026-04-01
## 2026-04-03
### 项目结构
- skills/ - 技能定义目录（包含各技能的 SKILL.md）
- commands/ - 命令定义目录
- .ai/ - AI上下文存储目录
- 根目录包含 CLAUDE.md 等配置文件
### 架构决策
- [Architecture] 采用多模块结构组织技能和命令
- [Architecture] 技能和命令支持多语言（-en.md, -zh.md）
## 2026-03-17
### 项目结构
- 每个命令/技能需要创建 3 个文件
# 项目重点 - 2026-04-03
> 本文件为自动归档，保存当日所有重点内容
### 历史错误记录
- [Error][已修复] 在 save-context skill 中缺少错误记录功能
- **错误现象**：模型切换上下文后，相同的错误反复出现
- **错误位置**：skills/save-context/SKILL.md
- **RootCause** 根本原因：
- 原设计只记录架构决策，未记录错误模式
- 缺少错误经验的结构化存储机制
- **Fix** 修复方法：
- 新增 [Error]、[RootCause]、[Fix]、[Lesson]、[Avoid] 标签
- 设计错误记录的标准化格式
- 修改文件分工：主文件只记录索引，归档文件记录详细内容
- **Lesson** 经验教训：
- 模型切换后无法继承历史错误记忆
- 需要显式记录错误模式供后续参考
- **Avoid** 避免方法：
- 每次发现错误时，立即记录到 context 文件
- 新会话开始时先读取历史错误记录
### 问题与解决方案
- [Question][已解决] 用户提出如何记录问题和解决方案
- **问题描述**：用户需要详细记录问题及解决过程，避免重复犯错
- **Solution** 解决方案：
- 设计结构化标签系统区分不同类型内容
- 使用日期归档文件存储详细内容
- 主文件只记录索引便于快速浏览
- **Result** 结果：✅ 已解决 - 成功添加了错误记录功能
### 关键决策
- [Decision] 采用索引 + 详细内容分离存储
- 主文件只记录归档文件路径，不重复内容
- 新会话可通过索引快速定位历史记录
- 避免内容重复和维护负担
# Context 初始化标记
# 本文件用于标记项目结构已保存，防止重复保存
initialized: true
initialized_at: 2026-04-03
.ai/context.md 了解项目背景.ai/context-YYYY-MM-DD.md（详细内容）.ai/context.md（索引）.ai/.context-initialized 是否存在.ai/context-YYYY-MM-DD.md.ai/context.md（添加索引）.ai/.context-initialized 标记文件不询问用户，直接保存（无打扰）
展示预览，等待确认：
📝 即将保存以下内容：
【.ai/context-2026-04-03.md】（详细内容）
### 历史错误记录
- [Error][已修复] 错误描述
- 错误现象：...
- 错误位置：...
- RootCause: ...
- Fix: ...
- Lesson: ...
- Avoid: ...
### 问题与解决方案
- [Question][已解决] 问题描述
- 问题描述：...
- Solution: ...
- Result: ...
【.ai/context.md】（索引更新）
### 历史错误记录
- 详见 [.ai/context-2026-04-03.md](.ai/context-2026-04-03.md) - 2026-04-03
### 问题与解决方案
- 详见 [.ai/context-2026-04-03.md](.ai/context-2026-04-03.md) - 2026-04-03
确认请回复"确认"或"y"，取消请回复"取消"或"n"
| 标签 | 含义 |
|---|---|
[Question] | 用户提出的问题或需求 |
[Solution] | 解决方案及决策过程 |
[Decision] | 关键决策点及理由 |
[Issue] | 发现的问题或 Bug |
[Result] | 结果说明 |
| 标签 | 含义 |
|---|---|
[Error] | 曾经犯过的错误 |
[RootCause] | 错误根本原因分析 |
[Fix] | 错误修复方法 |
[Lesson] | 经验教训 |
[Avoid] | 如何避免同类错误 |
| 状态 | 含义 |
|---|---|
[待解决] | 问题已记录，待处理 |
[进行中] | 正在解决 |
[已解决] | 问题已解决 |
[已修复] | 错误已修复 |
[已搁置] | 暂时搁置 |
当首次工具调用触发时，保存项目结构概述：
### 项目结构
- skills/ - 技能定义目录
- commands/ - 命令定义目录
- .ai/ - AI上下文存储目录
- 根目录包含 CLAUDE.md 等配置文件
用户通过 /save-context 手动触发时：
识别错误模式：
问题与解决方案记录：
### 问题与解决方案
- [Question][进行中] 问题描述
- **问题描述**：详细描述问题
- **Solution** 解决方案：
- **方案设计**：详细的解决思路
- **备选方案**：考虑过哪些其他方案
- **实施步骤**：具体的操作步骤
- **Result** 结果：✅/❌
历史错误记录：
### 历史错误记录
- [Error][已修复] 错误标题
- **错误现象**：具体表现
- **错误位置**：模块/文件/函数
- **RootCause** 根本原因：
- **Fix** 修复方法：
- **Lesson** 经验教训：
- **Avoid** 避免方法：
每次发现错误立即记录：
新会话开始时：
.ai/context.md 了解项目索引