docs(agent): 补充 ai-proj submit/review 流转接口契约

2026-09-24 11:05:36 +08:00
parent 89af0c45fc
commit 0e7c7e778b
1 changed files with 1 additions and 1 deletions
@@ -13,7 +13,7 @@
 - REST base 推导：mcp.json 里 ai-proj 的 url 去掉尾部 `/mcp/sse`（即 `https://ai.pipexerp.com/api/v1`），认证头 `X-API-Key` 同 mcp.json。
 - ⚠️ 本机 shell（Bash 工具）直读 `~/.kimi-code/mcp.json` 会被托管层拦截（"local Shell bypass is disabled for a managed MCP route"）；用 Read 工具读取不受限。
 - 任务跨项目用 `move_task`，再 `link_tasks_to_requirement`（role=implementation）。
- REST 建需求/任务实测（2026-09-24）：`POST /requirements` 与 `POST /tasks` 的 body 带 `project_id:224` 会创建失败/被忽略，先裸建再走 reassignment；关联用 `POST /requirements/{id}/tasks` body=`{task_id, role:"implementation"}`；更新用 `PUT /requirements/{id}`（不支持 PATCH），`delivery_stage` 为只读（PUT 静默忽略），released 由 CLI sync 或界面流转。
+- REST 建需求/任务实测（2026-09-24）：`POST /requirements` 与 `POST /tasks` 的 body 带 `project_id:224` 会创建失败/被忽略，先裸建再走 reassignment；关联用 `POST /requirements/{id}/tasks` body=`{task_id, role:"implementation"}`；更新用 `PUT /requirements/{id}`（不支持 PATCH），`delivery_stage`/`reviewer_id` 为只读（PUT 静默忽略）；`POST /requirements/{id}/submit` 可推进 draft→pending 并自动分配评审人，`POST /requirements/{id}/review` 仅评审人可调用；released 由 CLI sync 或评审/界面流转。
 - 本机无 ai-proj CLI，远程同步需在有 CLI 的机器执行 `ai-proj sync requirement --id <id> --direction to_remote`。

 ## 生产 ES 集群关键坑