# 派对 AI 开发规则

## 与本仓库 `.cursor` 的优先级（避免入口打架）

- **三端编码与接口**：以本仓库 `.cursor/rules`（如 `soul-project-boundary.mdc`）与 `.cursor/skills` 为准——小程序/管理端/soul-api 路由隔离、变更检查、角色 Skill 加载等**不因派对 AI 而绕过**。
- **派对 AI 目录**：若仓库根下存在 `派对AI/`，开发前可补充读取其 `BOOTSTRAP.md`、`SKILL_REGISTRY.md`，用于派对域身份、运营与流程；与 `.cursor` 冲突时，**代码与 API 约定以 `.cursor` 为准**。
- **卡若 AI 全局规则**：仅在本会话需要时参考；本仓库会话自检仍以 **本仓库 `.cursor/`** 为主。

## 强制：使用派对 AI 进行开发（当 `派对AI/` 存在时）

所有开发操作**优先结合派对 AI**（路径：**仓库根下的** `派对AI/`，与 `miniprogram/` 同级）。若本仓库无 `派对AI/` 目录，则跳过本节启动顺序，仅按 `.cursor` 执行。

### 启动顺序

1. 读取 `派对AI/BOOTSTRAP.md` — 了解项目 AI 身份与团队
2. 读取 `派对AI/SKILL_REGISTRY.md` — 查找对应技能
3. 按匹配的 SKILL.md 执行

### 开发复盘推送飞书群

每次开发完成后，**必须将复盘内容推送到 Soul 创业派对开发资料群**：

```
飞书 Webhook: https://open.feishu.cn/open-apis/bot/v2/hook/c558df98-e13a-419f-a3c0-7e428d15f494
```

推送格式：

```json
{
  "msg_type": "text",
  "content": {
    "text": "[开发复盘] 日期时间\n\n🎯 目标：...\n📌 结果：...\n💡 关键判断：...\n📝 遗留：...\n▶ 下一步：..."
  }
}
```

### 需求必须 100% 完成（铁律）

**禁止**：说「留到下一轮迭代」「后续再处理」。
收到需求文档后，**全量开发**到每一项功能都落地为止。
若单个功能涉及跨端改动（后端 + 管理端 + 小程序），必须三端同步改完。
仅当功能在代码层面**无法实现**（如依赖第三方审核、硬件条件不具备）时，才可标注「依赖外部」并说明原因。

### 复盘格式

使用卡若 AI 标准复盘格式（🎯📌💡📝▶ 五块齐全），带日期+时间。
开发完成后**必须**立即发送飞书复盘（不需要用户提醒）。

### 小程序上传约定（强制）

- **版本号固定 `1.2.6`**：每次上传小程序（soul-party / 派对AI）统一使用版本 `1.2.6`，不递增。
- **上传后设为体验版**：上传完成后自动设为体验版，方便扫码测试。
- **不自动提交审核**：上传后默认不提交审核。只有用户明确说「上传审核」「提交审核」时，才执行审核提交。
- **上传命令**：
  ```bash
  # 上传 + 体验版（默认，不提审）
  python 开发文档/小程序管理/scripts/mp_deploy.py deploy soul-party --skip-cert
  # 上传 + 体验版 + 提交审核（用户明确要求时）
  python 开发文档/小程序管理/scripts/mp_deploy.py deploy soul-party --skip-cert --submit
  # 单独提交审核（已上传后）
  python 开发文档/小程序管理/scripts/mp_deploy.py submit soul-party
  ```