From e70fd85cd1c062fdbcb8fcf85e8695cea5226f42 Mon Sep 17 00:00:00 2001 From: tizerluo <192086140+tizerluo@users.noreply.github.com> Date: Sun, 16 Aug 2026 05:08:10 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(skill):=20=E4=B8=A4=E5=A4=84=E5=8B=98?= =?UTF-8?q?=E8=AF=AF=20=E2=80=94=20tool=20=E8=AE=A1=E6=95=B0=E4=B8=8E?= =?UTF-8?q?=E9=99=90=E6=B5=81=E6=8E=AA=E8=BE=9E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 「暴露三个标准 MCP tool」实为四个 (表格列了 get_zcode_capabilities/ zcode_review/zcode_security_review/zcode_pr_review) - 限流措辞恢复「除读附件外」限定 + 自我纠结警告: 附件要靠 Read 工具读, 裸写「不要调用工具」会让模型纠结浪费推理 (2026-07-08 实测教训, drive-zcode 个人版一直保留, 蓝本改写时丢失) --- skills/zcode-bridge-guide/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/zcode-bridge-guide/SKILL.md b/skills/zcode-bridge-guide/SKILL.md index 7d3796c..3bb56a4 100644 --- a/skills/zcode-bridge-guide/SKILL.md +++ b/skills/zcode-bridge-guide/SKILL.md @@ -144,7 +144,7 @@ ANTHROPIC_API_KEY="$api_key" ZCODE_BASE_URL="$base_url" ZCODE_MODEL="$model" \ 1. **不支持 stdin 管道**：不能 `cat file | zcode --prompt`，必须用 `--attach` 2. **无流式输出**（`--stream-json` 不支持）：turn 结束一次性返回 3. **tool call 轮次不稳定**：duration 38s~100s+，有时不完成 -4. **自由 prompt 可能触发限流**：开放式 prompt 会 spawn 多个 explore 子代理，撞 z.ai 限流。修法：把证据塞进 `--attach`，prompt 写明「不要调用工具/不要 spawn 子代理，只基于附件推理」。MCP server 的 `zcode_review` / `zcode_security_review` 两个 tool 已内置此纪律（prompt 内置「只审不修」约束 + 写/执行工具物理禁用 + 证据走附件），走 MCP 调用时无需手工处理 +4. **自由 prompt 可能触发限流**：开放式 prompt 会 spawn 多个 explore 子代理，撞 z.ai 限流。修法：把证据塞进 `--attach`，prompt 写明「**除读附件外**不要调用工具、不要 spawn 子代理，只基于附件推理」。⚠️ 措辞必须留"读附件"口子——附件要靠 Read 工具读，裸写「不要调用工具」会让 ZCode 自我纠结浪费推理（2026-07-08 实测）。MCP server 的 review 类 tool（`zcode_review` / `zcode_security_review` / `zcode_pr_review`）已内置此纪律（prompt 内置「只审不修」约束 + 写/执行工具物理禁用 + 证据走附件），走 MCP 调用时无需手工处理 --- @@ -303,7 +303,7 @@ ACP bridge 暴露的 ZCode 新版协议方法，按定位维度分组。**sessio ## 模式三：MCP tools（MCP client 内直接调用） -MCP server 暴露三个标准 MCP tool，供 Claude Code / Cursor 等 MCP client 调用。 +MCP server 暴露四个标准 MCP tool，供 Claude Code / Cursor 等 MCP client 调用。 ### 注册到 MCP client From 82cf1c0b03a75c557601a9b1d4b056b04ad415c1 Mon Sep 17 00:00:00 2001 From: tizerluo <192086140+tizerluo@users.noreply.github.com> Date: Sun, 16 Aug 2026 05:31:22 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(skill):=20=E7=8B=97=E9=A3=9F=20review?= =?UTF-8?q?=20P2=20=E9=97=AD=E7=8E=AF=20=E2=80=94=20'=E6=AD=A4=E7=BA=AA?= =?UTF-8?q?=E5=BE=8B'=E6=94=B9'=E7=AD=89=E6=95=88=E7=BA=AA=E5=BE=8B'=20+?= =?UTF-8?q?=20=E6=88=90=E5=8A=9F=E5=88=A4=E5=AE=9A=E8=A1=A5=20zcode=5Fpr?= =?UTF-8?q?=5Freview?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/zcode-bridge-guide/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/zcode-bridge-guide/SKILL.md b/skills/zcode-bridge-guide/SKILL.md index 3bb56a4..e567c5a 100644 --- a/skills/zcode-bridge-guide/SKILL.md +++ b/skills/zcode-bridge-guide/SKILL.md @@ -144,7 +144,7 @@ ANTHROPIC_API_KEY="$api_key" ZCODE_BASE_URL="$base_url" ZCODE_MODEL="$model" \ 1. **不支持 stdin 管道**：不能 `cat file | zcode --prompt`，必须用 `--attach` 2. **无流式输出**（`--stream-json` 不支持）：turn 结束一次性返回 3. **tool call 轮次不稳定**：duration 38s~100s+，有时不完成 -4. **自由 prompt 可能触发限流**：开放式 prompt 会 spawn 多个 explore 子代理，撞 z.ai 限流。修法：把证据塞进 `--attach`，prompt 写明「**除读附件外**不要调用工具、不要 spawn 子代理，只基于附件推理」。⚠️ 措辞必须留"读附件"口子——附件要靠 Read 工具读，裸写「不要调用工具」会让 ZCode 自我纠结浪费推理（2026-07-08 实测）。MCP server 的 review 类 tool（`zcode_review` / `zcode_security_review` / `zcode_pr_review`）已内置此纪律（prompt 内置「只审不修」约束 + 写/执行工具物理禁用 + 证据走附件），走 MCP 调用时无需手工处理 +4. **自由 prompt 可能触发限流**：开放式 prompt 会 spawn 多个 explore 子代理，撞 z.ai 限流。修法：把证据塞进 `--attach`，prompt 写明「**除读附件外**不要调用工具、不要 spawn 子代理，只基于附件推理」。⚠️ 措辞必须留"读附件"口子——附件要靠 Read 工具读，裸写「不要调用工具」会让 ZCode 自我纠结浪费推理（2026-07-08 实测）。MCP server 的 review 类 tool（`zcode_review` / `zcode_security_review` / `zcode_pr_review`）已内置等效纪律（prompt 内置「只审不修」约束 + 写/执行工具物理禁用 + 证据走附件——prompt 措辞与手工版不同，靠物理禁用达成同一目的），走 MCP 调用时无需手工处理 --- @@ -443,7 +443,7 @@ npm test # 全量，看实际数字 - 流式事件中的 `agent_message_chunk` → 文本输出（真流式有多段） ### MCP 模式 -- `zcode_review` / `zcode_security_review` 返回 `{content: [{type: "text", text: "..."}]}`；text 是 zcode `--json` 输出中提取的 `response` 字段（输出非 JSON 时原样返回） +- `zcode_review` / `zcode_security_review` / `zcode_pr_review` 返回 `{content: [{type: "text", text: "..."}]}`；text 是 zcode `--json` 输出中提取的 `response` 字段（输出非 JSON 时原样返回） - `isError: true` → 失败 ---