核心用法
DevLog Skill 是为 OpenClaw 代理设计的专业开发日志系统,基于 dev-log-cli 命令行工具实现。核心工作流包括:
1. 日志录入:通过 devlog add 记录关键进展、阻塞问题或里程碑,支持项目绑定、状态标记(completed/in-progress/blocked 等)及标签分类
2. 历史追溯:使用 devlog list 查看近期活动,devlog search 按关键词检索历史上下文
3. 项目健康度:devlog stats 提供量化统计,辅助判断项目节奏与风险
4. 数据修正:devlog view/edit 支持条目级的精读与修正
数据以结构化形式存储于本地 SQLite 数据库,确保离线可用性与查询效率。
显著优点
- 代理原生设计:专为 AI 代理的"无状态"特性打造,每次交互可快速加载项目上下文
- 结构化数据:相比纯文本日志,支持按项目、状态、标签多维筛选,便于自动化分析
- 轻量无依赖:仅依赖 Python CLI 工具,无重型后端服务
- 开源可审计:代码托管于 GitHub,PyPI 分发流程透明
潜在局限
- 单用户架构:SQLite 本地存储意味着不支持多代理实时协作,需借助外部同步机制
- 生态成熟度:GitHub 仓库维护者单一(CrimsonDevil333333),社区贡献度与长期维护存疑
- 无云备份:数据丢失风险完全由用户承担,需自行配置备份策略
- ClawHub 待发布:官方市场页面尚未上线,安装流程需手动介入
适合人群
- 个人开发者或小型团队中的 AI 辅助编程场景
- 需要离线工作、重视数据隐私的敏感项目
- 代理开发者希望为 AI 助手建立可查询的"记忆系统"
常规风险
- 数据完整性:SQLite 文件损坏可能导致日志丢失,建议定期
.dump备份 - CLI 版本漂移:
dev-log-cli更新可能引入破坏性变更,需锁定版本 - 权限边界:代理若获得 shell 执行权限,需确保
devlog命令的调用范围受控,防止通过--project参数注入路径遍历