---
description: 把 KB 流程摩擦提交为 Gitee Issue（不写业务仓反馈目录、不改流程文件）
argument-hint: <反馈内容>
---

> Pi 包 `@suwenguang/pi-kb`：运行时包根为环境变量 `PI_KB_ROOT`（由 `extensions/kb-root.ts` 注入）。
> 工种子 Agent 通过 **pi-subagents** 派发（已 bundled）；agent 定义见本包 `agents/`。
> 脚本调用示例：`node "$PI_KB_ROOT/scripts/<name>.mjs"`。

## 用户输入

${@:-（未附带参数；结合当前对话上下文执行，缺信息时向用户澄清。）}

---
把用户在使用 `/kb-*` 时遇到的**流程级摩擦**提交到上游 Gitee 仓库 Issue。本命令是进化闭环的**传感器**：只开 Issue（或同因追加评论），**不**修改任何流程文件，**不**在业务仓写反馈文件。

完整口径：[kb-feedback-gitee.md](../skills/kb-workflow/references/kb-feedback-gitee.md)。

**输入**: 自由描述。例如：`/kb-feedback archive 步骤经常忘发群通知，建议加门禁`。可附带触发命令、严重度。

本会话多次摩擦或收工复盘 → 优先 `/kb-session-retro`（自动开 Issue）；本命令适合**单条明确吐槽**。

## Bootstrap 门禁（本命令豁免）

本命令只向上游开 Issue，**不依赖**业务仓 KB 骨架。**禁止**跑 `kb-bootstrap-check.mjs` 并因未初始化而停止——未 `/kb-init` 的仓也应能反馈「门禁/初始化」类摩擦。

## 约束

- **禁止**创建或修改 `knowledge/工程平台/KB工作流/反馈/`（及任何本地 FB 文件）。
- **禁止**修改 `prompts/`、`skills/`、`agents/`、schema、业务代码。
- **禁止**建议在业务仓直接跑 `/kb-evolve`（应引导 Issue 等待合入，或 `/kb-evolve-setup` 后在源码仓进化并提 MR）。
- 需要 Gitee token（`GITEE_ACCESS_TOKEN` 或一次 `node "$PI_KB_ROOT/scripts/kb-config.mjs" set-token`）；缺失时脚本失败，提示配置令牌（勿在对话中反复粘贴全文）。
- 诊断来源：`node "$PI_KB_ROOT/scripts/kb-config.mjs" show-source`。
- **区分对象**：流程规则摩擦 → 本命令；某变更验收问题 → `/kb-verify-issue`；知识库正文过期 → `/kb-sync`。
- **主 Agent 不写文件**：Issue 创建/评论由子 Agent 调 `kb-gitee-issue.mjs` 完成。

## Issue 正文模板

Title：`[流程反馈] <中文主题>`

Body（写入临时文件再 `--body-file`）：

```markdown
[pi-kb-feedback]

| 字段 | 内容 |
|---|---|
| 触发命令/阶段 | 如 /kb-archive、全局 |
| 严重度 | 高 / 中 / 低 |
| pi-kb 版本 | <读 $PI_KB_ROOT/package.json version> |
| 业务仓 | <basename pwd> |

## 现象
<实际摩擦>

## 期望
<希望流程变成什么样>

## 场景追加
- <YYYY-MM-DD：补充；新建时可写「无」>
```

## 执行步骤

1. **解析**：拆出主题、触发命令、现象、期望、严重度；信息不足时问一个关键问题。
2. **查重**：

```bash
node "${PI_KB_ROOT}/scripts/kb-gitee-issue.mjs" list --state open --labels pi-kb-feedback --json
```

与现有 open Issue 标题/现象同因时：对该 `#number` 执行 `comment`（追加场景与频次说明），**不**新建。

3. **新建**（无同因时）：

```bash
node "${PI_KB_ROOT}/scripts/kb-gitee-issue.mjs" create \
  --title "[流程反馈] <中文主题>" \
  --body-file /tmp/pi-kb-feedback-body.md
```

4. **回报**：Issue 编号 + URL；提示可等待维护者处理，或自行 `/kb-evolve-setup` 后在源码仓 `/kb-evolve` 并提 MR。

## 输出格式

```markdown
## 反馈已提交

| 项目 | 内容 |
|---|---|
| Issue | #<n>（新建 / 追加评论） |
| URL | https://gitee.com/suveng/pi-kb/issues/<n> |
| 触发 | <命令/阶段> |
| 严重度 | 高/中/低 |

下一步：等待合入；或 /kb-evolve-setup → 源码仓 /kb-evolve → MR。
```

## 退出口径

- 不推进变更阶段、不提交业务仓 git、不改流程文件。