devlog
开发日志存档工具。将日常工作中的关键节点（调试、方案设计、故障排查）结构化记录到 Markdown 文件。支持全局/项目本地双模式存储，具备智能防重功能，便于后续生成周报。
开发日志存档工具。将日常工作中的关键节点（调试、方案设计、故障排查）结构化记录到 Markdown 文件。支持全局/项目本地双模式存储，具备智能防重功能，便于后续生成周报。
DevLog
开发者的"第二大脑"，将碎片化工作上下文结构化存储。
使用方式
/devlog <category> <title> [-d detail] [--here|--path DIR]
分类 (category):
incident- 线上故障（必填根因与修复）feat- 业务需求design- 技术方案ops- 运维部署bug- 常规 Buglearn- 技术调研
存储选项:
- 无参数 → 全局默认（首次运行时配置）
--here→ 项目本地 (./.devlog/)--path DIR→ 自定义目录
示例
# 记录线上故障（全局）
devlog incident "首页Crash" -d "NPE in FeedAdapter.notifyDataSetChanged()，已添加空值检查"
# 记录技术方案（项目本地，可提交 git）
devlog design "Feed缓存策略" -d "Cache-Aside + TTL随机化" --here
# 记录常规 Bug
devlog bug "修复点赞数不刷新"
# 查看今日日志
devlog list --here
触发规则
显式触发（必须满足）：
- 用户说："记一下"、"存档"、"log this"、"archive"、"记录日志"
- 用户说中文："存一下"、"记录到日志"
仅在这些场景下触发：
- 完成一项明确的开发任务后（Debug成功、设计方案确认、代码实现完成）
- 用户明确要求记录时
禁止隐式触发：不要自动记录，始终让用户明确意图。
执行流程
- 识别分类和内容：根据用户输入判断分类和标题
- 确定存储位置：
- 默认使用全局存储
- 用户说"存到项目"、"here"、"本地"时使用
--here - 用户指定路径时使用
--path
- 调用脚本：
python3 ~/.claude/skills/devlog/devlog.py <category> "<title>" -d "<detail>" [options] - 解析反馈：将脚本的彩色输出转换为简洁的确认消息
反馈格式
执行成功后向用户展示：
✅ **已归档**
📂 `/path/to/file.md`
🏷️ [类别] 标题
输出格式
日志文件格式（Markdown）：
# 📅 2026-01-21 Work Log
### [14:30] `@Weibo_Project` INCIDENT: 修复首页 Crash
> Root Cause: NPE in FeedAdapter.notifyDataSetChanged()
> Fix: 添加空值检查，已提交 PR #123
### [11:15] `@Weibo_Project` DESIGN: Feed 缓存策略方案
> 采用 Cache-Aside + TTL 随机化防止雪崩
---
配置
首次运行：首次使用时会提示选择全局日志目录
devlog feat "测试" # 首次运行会触发配置向导
配置管理命令：
devlog config show # 查看当前配置
devlog config reset # 重置配置（重新触发向导）
配置文件：~/.claude/skills/devlog/.config（JSON 格式）
环境变量：支持 DEVLOG_GLOBAL_DIR 临时覆盖配置路径
You Might Also Like
Related Skills
update-docs
This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.
vercel
docstring
Write docstrings for PyTorch functions and methods following PyTorch conventions. Use when writing or updating docstrings in PyTorch code.
pytorch
docs-writer
Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
google-gemini
write-concept
Write or review JavaScript concept documentation pages for the 33 JavaScript Concepts project, following strict structure and quality guidelines
leonardomsoresource-curator
Find, evaluate, and maintain high-quality external resources for JavaScript concept documentation, including auditing for broken and outdated links
leonardomso
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
anthropics