cnb-npclisted
Install: claude install-skill Zi-Yi-Ming/cnb-npc-skill
# cnb-npc:把任务派发给 CNB CodeBuddy NPC
## 两种模式
| 模式 | 用法 | NPC 行为 | 产出 | 轮询目标 |
|---|---|---|---|---|
| 工作模式(默认) | `run "<任务>"` | 写代码、建分支、提 PR | PR | NPC 的 PR |
| 只读模式 | `run "<任务>" --no-work-mode` | 只读分析,不改代码 | 评论里的报告 | NPC 的评论 |
两种模式的建组织/仓库、推送、开 Issue 编排完全一致,区别只在 Issue 是否带 `work_mode` 字段以及轮询目标。
## 适用场景
- 用户有一个开发任务,希望交给 CNB 平台的 CodeBuddy NPC 在云端自动完成(理解需求 → 读代码 → 写代码 → 提 PR)。
- 用户想让 NPC 做**只读评审/分析**(代码评审、方案建议、批量排查),不要它改代码。
- 用户想把本地某个目录的代码推送到 CNB 仓库,让 NPC 在仓库上下文中干活。
- 用户刚接触 CNB,需要引导注册 + 生成访问令牌。
## 前提
- 本机已安装 Node.js(≥18,内置 fetch)和 git。
- 首次使用需要 CNB 账号 + 访问令牌(脚本会引导,全程只需人工做两件事:注册、粘贴令牌)。
## 使用步骤
### 1. 首次引导(仅一次)
```bash
node cnb-npc-skill/bin/cnb-npc.js onboard
```
脚本会:
1. 检测是否已有 Token(环境变量 `CNB_TOKEN` 或 `~/.cnb-npc/config.json`)——有则跳过;
2. 打开浏览器跳转 cnb.cool 注册页 和 cnb.cool/profile/token 令牌页;
3. 提示用户勾选授权范围(建议全选最省事):`group-manage:rw`(建组织)、`group-resource:rw`(建仓库)、`repo-issue:rw`(开 Issue + 工作模式)、`repo-pr:rw`(轮询/合并 PR)、`repo-code:rw`(推送/查分支)、`repo-basic-info:r`、`repo-notes:rw`(读 NPC 报告 + 发评论重触发)、`account-engage:r`(列组织);
4. 用户粘贴令牌 → 脚本用 `GET /user/groups` 校验 → 存入 `~/.cnb-npc/config.json`。
非交互环境(CI/无 TTY)下若没有 Token,脚本会直接报错并给出手动步骤,不会挂起等待输入。
### 2. 派发开发任务(工作模式,默认)
```bash
node cnb-npc-skill/bin/cnb-npc.js run "给 README 补一份 API 使用示例" --dir ./my-code
```
编排流程(全部自动):
1. **组织**:`--org` 指定;否则用已有的第一个组织;都没有则自动创建 `npc-workspace`;
2. **仓库**:`--repo` 指定(默认 `npc-task`);不存在则自动创建(默认 `private`);
3. **推送**:`--dir` 指定本地代码目录;未指定则生成一个含任务说明 README 的临时仓库。git 推送使用 `cnb` 用户 + 令牌密码,推送后 remote 会换回不带令牌的