devlog

Claude Code技能,结构化记录AI协作开发日志。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:devlog。
它的用途是:Claude Code技能,结构化记录AI协作开发日志。
完整的 Skill 内容见:https://321skill.com/skills/devlog/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘记一下,刚才我们讨论的Feed缓存策略方案,存到当前项目里。’,Claude会立即将这次设计讨论以‘DESIGN’分类记录到项目目录下的当日日志文件中。或者,在修复一个紧急Bug后,

对AI说:‘记录刚才修复的首页Crash,原因是NPE,已经添加空值检查。’,Claude会将其作为‘INCIDENT’归档,并包含根因和修复详情。

介绍

在AI结对编程的Vibe Coding时代,开发者与Claude的对话、调试、方案设计等大量有价值的工作过程往往转瞬即逝,难以追溯和复盘。devlog技能旨在解决这一困境,它允许你在与Claude的自然对话中,随手将关键工作节点(如修复Bug、讨论方案)结构化地记录下来,自动归档为Markdown日志,无需中断当前工作流。

使用方式非常灵活,既可以在Claude Code对话中直接说“记一下,刚才修复的Feed缓存问题”,Claude便会自动记录;也可以通过命令行工具,使用devlog feat ‘完成登录功能’等命令进行精细化的记录和管理。该技能支持将日志存储在全局目录用于个人周报,也可以存储在项目本地目录作为技术文档随代码提交。

它非常适合每天与AI深度协作、需要清晰追溯工作过程和产出周报的开发者,包括前端、后端、全栈及运维工程师等角色。对于项目经理或技术负责人,它也能帮助了解团队成员的隐性工作内容。

建议在项目初期就启用此技能,养成随手记录的习惯。对于线上故障(incident)务必记录根因和修复方案,这将成为宝贵的知识库。定期使用devlog weekly生成周报,能极大提升复盘和汇报效率。

核心特点

与通用笔记工具不同,devlog深度集成于Claude Code对话和工作流中,实现了“对话即记录”;它提供了专为开发场景设计的结构化分类(如incident, feat, design),并能智能区分全局流水账和项目本地文档,精准服务于开发日志和周报生成的核心需求。

注意事项

该技能主要服务于与Claude的协作记录,不适合记录与AI无关的纯手动操作或非结构化的随意笔记。

常见问题

devlog和普通的记事本有什么区别?

devlog专为开发者设计,集成在Claude Code中,支持结构化分类(bug/feat/design等)、自动时间戳、智能防重,并能一键生成周报,是面向开发工作流的专业日志工具。

记录的内容存储在哪里?安全吗?

内容默认以Markdown文件形式存储在您指定的本地目录(如~/devlog/或./.devlog/),完全在您的控制之下,不会上传到任何外部服务器。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/devlog/raw/index.md 读取 devlog 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。