用途 lov-plane-cli 用于通过命令行读写 Plane 项目管理实例，面向自托管或云端 Plane。它通过 Plane REST API v1 工作，适合“查看 Plane 上有哪些任务”“在 Plane 建个工作项”“把任务同步到 Plane”“查看某项目的进度、周期、模块”等场景。它不负责部署、启动或排障 Plane 实例本身，也不处理 Jira、Linear、Notion 等其他项目管理工具。
主要能力 命令表由随包的 cli/openapi.json 在启动时构建，覆盖 130 个操作、17 个资源分组，与实例导出的 schema 保持一致。覆盖分组及操作数包括：Work Items 14、Cycles 14、Members 13、Modules 12、Work Item Comments 10、Work Item Attachments 10、Work Item Links 10、Projects 8、Assets 6、workspaces 6、Intake 5、Labels 5、States 5、Stickies 5、Work Item Activity 4、Work Item Relations 2、Users 1。CLI 提供 help 查看全部命令及单命令帮助，支持 --dry-run 只打印请求而不发出；请求体可用 --data '<json>' 或 --data @file.json 传入；未知参数会直接报错。SDK 入口 cli/sdk/index.mjs 导出 PlaneClient，含常用入口与通用 request(method, path, {query, body})。
使用方式 首先确认 Node.js 20+，CLI 入口为 $SKILL_DIR/cli/bin/lov-plane-cli.mjs，若已 npm link 可直接使用 lov-plane-cli。实例地址按 --base-url、$PLANE_BASE_URL、配置文件 baseUrl、http://localhost 的顺序解析；凭据按 --api-key、$PLANE_API_KEY、配置文件 apiKey 的顺序解析。token 可在 Plane 登录后通过头像 → Settings → API tokens → Add API token 获取。凭据只经环境变量或用户自有配置文件传入，不应写入生成文件、示例、日志或回复中。缺凭据时 CLI 以退出码 2 停止并打印获取指引。常用命令示例：lov-plane-cli list-projects -w <workspace-slug>；lov-plane-cli list-work-items -w <slug> -p <project-id> --per-page 50；lov-plane-cli list-states -w <slug> -p <project-id>；lov-plane-cli create-work-item -w <slug> -p <project-id> --data '{"name":"新任务"}'。
写操作与限制 create-、update-、delete-、archive- 会改变真实项目数据；删除、归档、批量修改应先确认再执行，创建工作项前应先取 list-states / list-labels 的 id，不要猜 UUID。写操作后应回读对应资源确认结果，不把 2xx 当作最终验收。常见状态码：401 未提供凭据；403 token 无效或无权访问；404 slug 或 id 不存在，CLI 会原样保留 Plane 的错误体。OpenAPI 由 Plane 自托管实例内置的 drf-spectacular 导出，未人工改写路径或字段，仅修正 servers 并补充证据标注；每个操作带 x-observation，17 个端点经真实探测确认存在，113 个仅有 schema 定义，所有写操作从未在线执行过，字段语义以 Plane 官方文档为准。Plane 升级后接口可能变化，重新导出 schema 覆盖 cli/openapi.json 即可同步，无需改代码。