基于 CNB (cnb.cool) 平台的 AI 协作研发团队，通过 NPC 实现需求评审、任务分配、编码开发、代码 Review 的自动化流程。

产品录入 Issue → 需求评审 NPC 评审 → 研发 Leader NPC 分配任务
    → 开发者 NPC 输出方案 → 研发 Leader 确认方案
    → 开发者 NPC 编码 + 提 PR → 研发 Leader + 真人 Review
    → PR 合入 → 研发 Leader 标记待发布

步骤	操作者	动作	Issue 状态
1	👤 产品	创建 Issue，打 status:pending-review 标签	status:pending-review
2	🤖 需求评审员	评审 Issue，给出评审意见，通过后流转状态	→ status:reviewed
3	🤖 研发 Leader	评估复杂度/模块/AI 可行性，@开发者分配任务	→ status:developing
4	🤖 开发者	输出技术方案，待研发 Leader 确认	status:developing
5	🤖 开发者	创建分支，编码，提交 PR	status:developing
6	🤖 开发者	@研发 Leader review + 分析 git log 邀请真人 review	status:developing
7	🤖 研发 Leader	定时扫描，PR 合入后标记待发布	→ status:ready-to-deploy

角色	职责	唤醒方式	工作模式
📋 需求评审员	评审 Issue 质量，给出修改建议，达标后流转状态	@xiaohuan/ai-team/demo(需求评审员)	✅ 需要
🎯 研发 Leader	任务分配、方案确认、代码 Review、状态跟踪	@xiaohuan/ai-team/demo(研发Leader)	✅ 需要
💻 开发者	技术方案、编码、提 PR、邀请 Review	@xiaohuan/ai-team/demo(开发者)	✅ 需要

标签	含义	设置者
status:pending-review	待评审	产品（人工）
status:reviewed	已评审	需求评审员 NPC
status:developing	开发中	研发 Leader NPC
status:ready-to-deploy	待发布	研发 Leader NPC

标签	用途
priority:P0 ~ priority:P3	优先级
type:feature / type:bugfix	需求类型
module:xxx	归属模块（由研发 Leader 评估后打上）
ai:yes / ai:no	是否可由 AI 完成

本项目使用 CNB 原生 crontab 定时触发 NPC 执行，无需外部定时系统：

定时任务	执行频率	NPC 角色	功能
需求评审	每 30 分钟	需求评审员	扫描 status:pending-review 的 Issue 并评审
任务分配	每小时整点	研发 Leader	扫描 status:reviewed 的 Issue，评估并分配给开发者
PR 状态检查	每 30 分钟	研发 Leader	扫描 status:developing 的 Issue，PR 合入后标记待发布

所有定时任务配置在 .cnb.yml 的 main 分支下，使用 crontab: 语法，时区为 Asia/Shanghai。

demo/
├── .cnb/
│   └── settings.yml      ← NPC 角色定义（3 个角色 + prompt）
├── .cnb.yml               ← 流水线配置（crontab 定时任务，使用 CNB 默认 NPC 行为）
└── README.md              ← 本文件

注意：本项目不使用自定义 NPC 镜像，直接使用 CNB 平台默认的 NPC 运行时。无需 Dockerfile。

1. 推送代码：将本工程推送到 xiaohuan/ai-team/demo 仓库的 main 分支
2. 创建 Issue：产品同学创建 Issue，手动打上 status:pending-review 标签
3. 等待定时触发：需求评审员 NPC 会在下一个 30 分钟周期自动评审
4. 手动触发：也可以在 Issue 中 @xiaohuan/ai-team/demo(需求评审员) 立即触发评审（勾选「替我上班」）

• 🔴 NPC 绝不能直接合入 PR — 所有角色的 prompt 都包含此约束
• 🔴 代码 Review 需真人参与 — 开发者 NPC 会分析 git log 邀请真人 review
• 🟡 工作模式显式开启 — NPC 操作代码/标签需勾选「替我上班」
• 🟢 Issue 标签单一性 — 同一时间只保留一个 status 标签

• CNB 平台 — DevOps 平台
• CNB NPC 文档 — NPC 配置文档
• CNB 定时任务文档 — crontab 语法文档