# 流程进化: kb-admin 单轮边界与 Cursor 子会话工具面

| 字段 | 内容 |
|---|---|
| 版本 | 0.1.15（本轮不 bump package；合入后由维护者 bump） |
| 日期 | 2026-07-26 |
| commit | 7937f26 |
| MR | https://gitee.com/suveng/pi-kb/pulls/14 |
| 分支 | evolve/kb-admin-single-round |

## 改动文件

- `agents/kb-admin.md`：新增「kb-admin 单轮边界」——读盘 + 首批派发即结束；禁止单 chain 等全长 pipeline；Cursor ~5min 硬顶
- `prompts/kb-orchestrator.md`：新增「kb-admin 多轮接力」与「完成功能」多轮口径；exit 143 零派发时主 Agent 默认续派
- `skills/kb-workflow/references/kb-cursor-sdk.md`：§3.1 子会话工具面差异、`pi__subagent` fallback 为 Cursor Task、timeoutMs 未必传递

## 设计取舍

- kb-admin 单轮短平快，避免 Cursor SDK 子会话 ~5 分钟 SIGTERM 导致零 builder 派发。
- 全长 standard 流由主 Agent **多轮** kb-admin 接力，而非一次 subagent 阻塞跑完。
- 本轮不 bump `package.json`；合入 main 后由维护者决定 publish。

## Issue 处置记录

| Issue | 结论 | 说明 |
|---|---|---|
| [IK49C2](https://gitee.com/suveng/pi-kb/issues/IK49C2) | 采纳 | kb-admin 单轮边界、Cursor Task fallback、多轮接力、超时文档 |

## EvoMap

- 未启用（`enabled=false`）；本轮无网络检索/回传。