doc-update
SkillAI & modelsCapture-correction workflow: record valuable learnings from the current conversation into CLAUDE.md or the relevant SKILL.md so the same mistake never recurs. Reviews conversation for corrections, new conventions, and doc-reality mismatches; proposes targeted updates confirmed by user before writing. TRIGGER whenever the user corrects Claude's approach or rejects an action — signals like "不对", "不要这样", "应该是", "错了", "其实是", "no, do X instead", "that's wrong" — and the correction reflects a reusable convention rather than a one-off. Also use when a doc-vs-code discrepancy is found, or the user supplies a convention Claude could not infer.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the doc-update skill
What this skill tells your AI
The instructions your AI receives, as published by windy10v10ai/game in .claude/skills/doc-update/SKILL.md and read by ahel’s review.
对话结束前或触发条件满足时，把本次对话中值得记录的内容沉淀到文档中。
触发场景
自动触发：
- 用户纠正了 Claude 的做法，且根源是文档记载缺失/错误
- Claude 发现文档描述与实际代码矛盾（路径不存在、字段改名、规则冲突）
- 用户提供了 Claude 无法自行推断的约定/上下文
手动触发：/doc-update
执行流程
第一步：识别候选内容
回顾对话，找出以下类型的事件：
| 类型 | 典型信号 | 示例 |
|---|---|---|
| 纠正 | 用户说"不对"、"不要这样做"、"应该是" | Claude 用了错误的路径或 API |
| 新约定 | 用户解释了某个规则，Claude 没有 | 文件命名约定、目录结构说明 |
| 文档矛盾 | CLAUDE.md 说 X 存在，但代码里没有 | 描述的路径不存在 |
| 工作流发现 | 某种做法在本项目特别有效或无效 | 某个 Skill 的触发条件需要调整 |
排除以下内容（不值得记录）：
- 代码中可直接读出的模式（命名规范、架构层次）
- 本次 task 的临时状态、当前进度
- 调试过程和 bug 修复配方（fix 在代码里，commit message 里）
- 已经在文档中有记载的信息
第二步：判断记录位置
| 内容类型 | 记录位置 |
|---|---|
| 项目级通用惯例、架构规则、常见陷阱 | CLAUDE.md（根目录） |
| 特定 skill 的执行细节、步骤修正 | 对应 .claude/skills/<name>/SKILL.md |
| 某个模块/子目录的专属约定 | 该目录下新建 CLAUDE.md |
优先更新已有条目，避免新增冗余段落。
第三步：用 AskUserQuestion 逐条确认
每条候选内容发起一次询问，说明：
- 发现了什么（哪里错了/缺了/新增了什么）
- 拟写入的具体内容（简明，不超过 3 行）
- 目标文件和位置
选项至少包含：写入 / 跳过。
每次最多 4 条并列询问，超过则分批。
第四步：实施确认的变更
- 更新内容时：找到目标章节，最小化修改（不重写整段）
- 新增内容时：插入语义最近的位置，不改变现有条目顺序
- 删除冗余时：仅删与代码现实矛盾的内容，其他保留
不要做的事
- 不要把对话摘要写入文档——只写非显而易见的约束或发现
- 不要重复已有记载——先搜索再写
- 不要为「可能有用」的信息写文档——没有明确使用场景则跳过
- 不要一次性写入大量内容——宁可少写，保持文档可扫读
Signals
- GitHub stars
- 73
- Forks
- 40
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
doc-update-windy10v10ai- Source
- github.com/windy10v10ai/game