核心用法
ClawPM 是一款以 JSON 为默认输出格式的多项目管理 CLI 工具，专为需要同时维护多个代码仓库的开发者设计。其核心工作流围绕「项目-任务-工作日志」三层结构展开：
1. 项目初始化：通过 clawpm project init 在当前目录创建 .project/ 配置，或利用 ~/clawpm/projects/ 路径实现 Git 仓库的自动识别与初始化
2. 任务管理：支持任务增删改查、状态流转（open → progress → done/blocked）、子任务拆分（--parent/split）及短 ID 快速引用（如 42 自动解析为 PROJ-042）
3. 工作日志：状态变更（start/done/block）自动记录至 work_log.jsonl，支持 log commit 关联 Git 提交，提供 tail --follow 实时追踪
4. Agent 上下文：clawpm context 输出结构化 JSON，包含项目元数据、进行中的任务、阻塞项、近期日志及 Git 状态，便于 AI Agent 快速恢复工作现场
显著优点
- JSON-First 设计：所有命令默认输出结构化数据，便于脚本集成与 Agent 消费，
-f text切换人类可读模式 - 自动项目检测：按「显式 flag → 当前目录向上遍历
.project/→ 已设置的 context → 自动初始化」四级回退，减少显式指定 - 轻量无依赖：单二进制文件，基于文件系统（
tasks/*.md状态文件）运作，无需数据库或服务端 - 工作流闭环：从任务创建、状态推进到 Git 提交关联，形成可追溯的开发日志
潜在局限
- 单用户场景：基于本地文件系统，无多用户协作或冲突解决机制
- 无 Web 界面：纯 CLI 工具，依赖终端操作，对非技术用户门槛较高
- Git 强依赖：自动初始化与
log commit等功能深度绑定 Git，非 Git 项目体验降级 - 可移植性限制：任务数据分散于各项目的
.project/目录，跨设备同步需自行解决（如 Git 子模块或云盘）
适合人群
- 同时维护 3-10+ 个代码仓库的独立开发者、技术负责人
- 需要为 AI Agent 提供标准化上下文的自动化工作流搭建者
- 偏好 Markdown/JSON 纯文本存储、拒绝 SaaS 订阅的本地优先派
常规风险
- 数据丢失风险：
work_log.jsonl为追加写入，无内置备份或回滚机制 - 权限问题：若项目目录权限配置不当，可能导致任务文件写入失败
- 环境变量覆盖：
CLAWPM_PORTFOLIO等变量被恶意篡改可导致数据写入非预期位置 - 短 ID 冲突：同一前缀下的数字 ID 存在碰撞可能，建议在关键操作中使用完整 ID