用途：为指定项目与议题追加结构化 JSON 工作日志，追踪进度、决策、经验与交接，方便后续 AI 或人工快速恢复上下文。
主要能力：支持多种条目类型，包括默认的普通进度、--decision 决策、--gotcha 注意事项、--handoff TO 交接、--phase NUM 阶段完成、--blocker 阻塞、--resolve ID 解决阻塞。每次写入后会更新 _state.json，便于快速加载当前状态；--state 可查看当前状态，--migrate 可从 WORKLOG.md 迁移。日志按 ideas/[project]/issues/[issue_id]-*/worklog/ 目录存放，条目文件命名为 {sequence:03d}-{type}-{slug}.json，并包含 _state.json 保存总体状态。
使用方式：命令形如 /worklog PROJECT ISSUE_ID [--type] "message"。例如 /worklog yourbench YB-2 "Added login button to header"；/worklog yourbench YB-2 --decision "Using Clerk for auth"；/worklog coordinatr 003 --handoff code-reviewer "Ready for review"；/worklog yourbench YB-2 --state。写入流程为解析参数、定位或创建 worklog 目录、计算下一个序号、创建条目文件、更新 _state.json。条目必需字段含 $schema、id、sequence、timestamp、type、author、summary。
适用场景：多人或多智能体协作时记录关键决策、踩坑、阶段完成与交接；需要为后续 AI 提供上下文时。
限制：资料未说明平台支持、权限、并发写入处理、安装命令或收费方式；完整 JSON schema 需参见 references/schema.md。