AGENTS.md@skills/plane-cli · git:20260925.4b67fd1 · 2026-09-25 · sha256 34b0047bcdc181c6

AGENTS.md@skills/plane-cli git:20260925.4b67fd1A

Immutable. This exact content never changes and is served at /api/v1/blob/34b0047bcdc181c6.

- Plane 的 429(error_code 5900)来自 ApiKeyRateThrottle,缓存键是 api_key:<token> 即按 token 计而非按 IP,换 IP 无效;自托管默认 60/minute,由 API_KEY_RATE_LIMIT 环境变量控制(2026-09-09, 124aa59)
- 面向未知实例批量写入时仍需节流并对 429 指数退避,因为限流阈值由对方部署决定;只有确认自托管已调高 API_KEY_RATE_LIMIT 才能全速跑(2026-09-09, 124aa59)
- 批量写入 work item 必须带 external_source 与稳定 external_id,回读时按 external_id 跳过已存在项,限流中断后才能原地续传而不产生重复(2026-09-09, 34bc9e6)
- API v1 没有 list-workspaces 端点,/api/v1/users/me/ 只返回 UserLite(id/email/display_name)不含 slug;workspace slug 只能由用户提供或用 ego-browser 复用登录态从 Web UI 的 /<slug>/ 路径读取(2026-09-09, 34bc9e6)
- Plane 内部 API(/api/workspaces/、/api/users/me/workspaces/)只认 session cookie,带 X-API-Key 一律 401,不要用它们兜底取 slug(2026-09-09, 34bc9e6)
- 工作项正文字段是 description_html 而非纯文本,写入前需 HTML 转义并按行包 <p>(2026-09-09, 34bc9e6)
- create-project 必填 identifier(≤12 字符)与 name,priority 枚举只接受 urgent/high/medium/low/none(2026-09-09, 34bc9e6)
- 用 JXA 全量导出 Apple Reminders 未完成事项耗时超过 120s,必须后台执行;按 list 批量取 name()/body()/dueDate() 数组比逐条属性访问快一个量级(2026-09-09, 34bc9e6)