Claude Code 记录开发日志和决策

Claude Code 安装步骤

打开 GitHub 固定提交的 `.claude/skills/devlog/SKILL.md`，核对内容与使用条件。
在自己的项目中创建 `.claude/skills/devlog/`，把核对后的文件保存为 `.claude/skills/devlog/SKILL.md`。
在该项目根目录启动 Claude Code，在斜杠菜单中选择 `/devlog`。

中文摘要

用简短的开发日志记录改动、决策依据、试错和后续事项，并为重大决策选用相应的文档类型。

SKILL.md 中文导读

可复现示例

虚构项目在 2026-07-09 决定复用排练筛选器。调查记录是 `{topic:'rehearsal-filter',decision:'reuse shared filter',rejected:'add second filter',reason:'avoid duplicate state'}`。现有日志没有这个主题。

工作步骤

先找同主题开发日志，再从当前上下文提取决策、依据与放弃的方案。
为新条目写日期、主题和决策类型，说明影响与待确认事项。

验收方法

新条目命名为 `2026-07-09-rehearsal-filter.md`，类型设为 `type: decision`。正文记录复用现有筛选器、避免重复状态的原因，以及第二套筛选器未采用的理由。保留一个待确认项以核对窄屏行为。

GitHub 原文 · 更新日期 2026-11-14

适用环境

Claude Code 项目及其开发日志目录。先查看是否已有同一主题的条目。

常见问题

开发日志何时该用 decision 类型？

当条目记录会影响后续设计的选择时，用 decision 类型，保存原因、备选方案和未解决问题。同一主题已有日志时可补写原条目。