From 89af0c45fc4878d67222d158461aecad826d1934 Mon Sep 17 00:00:00 2001 From: wangheng Date: Thu, 24 Sep 2026 11:01:03 +0800 Subject: [PATCH] =?UTF-8?q?docs(agent):=20=E8=AE=B0=E5=BD=95=E8=AE=BE?= =?UTF-8?q?=E5=A4=87=E7=94=9F=E5=91=BD=E5=91=A8=E6=9C=9F=E9=9C=80=E6=B1=82?= =?UTF-8?q?=E7=9A=84=20ai-proj=20=E5=85=B3=E8=81=94=E4=BF=A1=E6=81=AF?= =?UTF-8?q?=E4=B8=8E=20REST=20=E5=A5=91=E7=BA=A6=E5=AE=9E=E6=B5=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- xiaoqu-agent-service/AGENTS.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/xiaoqu-agent-service/AGENTS.md b/xiaoqu-agent-service/AGENTS.md index 82de46f..a464ad7 100644 --- a/xiaoqu-agent-service/AGENTS.md +++ b/xiaoqu-agent-service/AGENTS.md @@ -3,7 +3,7 @@ ## ai-proj 关联信息 - **ai-proj 项目 ID：224**（项目名 xiaoqu_agent_service）。本仓所有需求/任务创建后应挂到该项目，关联任务前确保任务也在项目 224。 -- 近期需求示例：REQ-20260921-0007（id 5778，设备电量消息查询工具，released）→ 任务 22306；REQ-20260919-0003（id 5747，出入库工具复查修复，released）→ 任务 22123。 +- 近期需求示例：REQ-20260924-0003（id 5800，设备生命周期查询工具，implementation 完成）→ 任务 22391；REQ-20260921-0007（id 5778，设备电量消息查询工具，released）→ 任务 22306；REQ-20260919-0003（id 5747，出入库工具复查修复，released）→ 任务 22123。 ## ai-proj MCP 已知限制与真实契约 @@ -13,6 +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 或界面流转。 - 本机无 ai-proj CLI，远程同步需在有 CLI 的机器执行 `ai-proj sync requirement --id --direction to_remote`。 ## 生产 ES 集群关键坑