cunkebao_v3/.cursor/skills/需求协调与归档/SKILL.md

name, description

name	description
需求协调与归档	存客宝四端需求维护与文档收敛：一项目一进行中MD、已完成只进已完成/、关单分拣、COORD、0530维护经验。触发词：需求协调、需求归档、四端汇总、已完成、进行中、修改目录整理、一项目一文件、关单、需求维护。

需求协调与归档 Skill（存客宝 v3 · 0530 维护版）

未完成横表：开发文档/1、需求/修改/YYYYMMDD_四端未完成需求汇总.md
已完成总汇：开发文档/1、需求/修改/已完成/YYYYMMDD_四端已完成与全量检测总汇/（不在根目录）
端真源：开发文档/1、需求/修改/{项目}_进行中_{YYYYMMDD}.md（每端最多 1 个）
卡若AI 母 Skill：/Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水泉_规划拆解/需求协调/SKILL.md
单篇整理：开发需求文档整理/SKILL.md

---

一、何时启用

场景	动作
新 P0/P1 需求	写入对应端 _进行中 · 禁止另开 {项目}_{主题}.md
需求写完仅文档	在 _进行中 内写 固定规则+验收 · 状态标 ⬜
验收通过	迁入 已完成/{项目}_{主题}_{date}/ · 更新 已完成总汇 §索引
端 100% 关单	删除 根目录 {端}_进行中 · 总汇保留链接
日终 / 分拣	更新 四端未完成需求汇总 · 已完成项 移出 根目录
跨端依赖	COORD 写入 各端 _进行中「跨项目协调」小节

---

二、目录纪律（0530 收敛 · 强制）

开发文档/1、需求/修改/
├── README.md
├── YYYYMMDD_四端未完成需求汇总.md      ← 唯一四端横表
├── 存客宝_进行中_YYYYMMDD.md           ← 含该端全部未完 + P0 全文
├── 触客宝_进行中_YYYYMMDD.md
├── AI数智员工_进行中_YYYYMMDD.md       ← 有未完才保留
├── images/
└── 已完成/
    ├── README.md
    ├── YYYYMMDD_四端已完成与全量检测总汇/
    │   └── 同名.md                     ← 已完成唯一总入口
    └── {项目}_{功能主题}_{YYYYMMDD}/
        ├── 同名.md
        └── images/

禁止（本轮维护教训）

禁止	正确做法
根目录 四端已完成*.md	只放 已完成/…/四端已完成…/
同项目两个 MD（_进行中 + 专文）	P0 全文 并入 _进行中 · 旧专文 归档 到 已完成/
已关单端仍留 _进行中 stub	SuperAdmin 100% → 无根目录 _进行中
根目录堆 存客宝_流量池_* / 触客宝_手机_*	合并进 存客宝_进行中 / 触客宝_进行中
文件名 初刻宝/初客宝/触刻版	统一 触客宝
COORD 只写横表	必须写入各端 _进行中
仅文档却开第二个「真源」	一个端一个真源

---

三、0530 维护期经验（固定写法）

3.1 需求文档结构（P0 块）

每个 P0 在 _进行中 内必须含：

1. 问题表（卡若原话 / 截图路径）
2. 根因（代码文件 · 现状 vs 期望）
3. 固定规则（归一化、合并键、禁止项 · 不可写抽象）
4. 接口清单（不变 URL）
5. 代码锚点（待建/已有路径）
6. 验收表（可数字 · V1～Vn）

3.2 只写文档不开发

• 状态标 「P0 · 仅文档 · 待开发」
• 同步 开发文档/5、接口/开发进度_接口文档.md 顶部一节
• 不为专文单独占根目录文件名

3.3 已完成 vs 进行中边界

状态	放哪
代码 ✅ · 待目视 🟡	进行中留一行 · 细节进总汇或 已完成/ 批次
代码 ✅ · 验收 ✅	移入 已完成/ · 从 _进行中 删该行
运营 P2（签字/Key 轮换）	写横表 · 不占 P0 开发 slot
全端 100%	无 _进行中 · 链总汇 §二

3.4 典型 P0 模板（本轮实例）

端	主题	要点
存客宝	流量池去重+RFM	M1–M4 同人键 · poolKeywords 并集 · 02:20/02:30 cron · 四维度
触客宝	手机↔PC 会话	抽 useKefuSessionBootstrap · message/list
触客宝	手机微信号切换	顶栏 头像+Popup · MobileWechatAccountSwitcher
触客宝	AI 获客 §十四	已添加态 · 去 Webhook · sort=rfm · 标签打勾 已添加·{微信号}
跨端	COORD-006	CompanyWechatScopeService · 设备/微信同源

3.5 截图与 images

• 路径：修改/images/{项目}_{现象}_{YYYYMMDD}.png
• _进行中 内引用：./images/…
• 关单迁 已完成/{批次}/images/ 时 改相对路径

---

四、COORD 分配（写入各端 _进行中）

COORD	简述	写入文档
001	SuperAdmin 开放 API	存客宝（提供）、SuperAdmin、触客宝、AI数智员工
002	aistaff 勿入客户池	SuperAdmin、AI数智员工
003	RFM 估值同口径	SuperAdmin、触客宝、存客宝流量池
004	AI 数智员工扫码绑定	存客宝、AI数智员工
005	Soul 永平同步	存客宝
006	设备/微信项目同源	存客宝、触客宝

各端固定小节：

## 跨项目协调（本端）

| COORD | 简述 | 角色 | 状态 | 阻塞本端 |
|:---|:---|:---|:---:|:---|
| 006 | 设备/微信同源 | 提供/消费 | ✅/⬜ | … |

---

五、关单流程（逐步）

1. 开发/文档完成 → 更新 {端}_进行中 状态 ✅
2. 全文批次 → 已完成/{项目}_{主题}_{date}/同名.md
3. 更新 已完成/…/四端已完成总汇.md §二～§三 索引（勿在根目录复制）
4. 从 _进行中 删除已完成行；若端无未完 → 删除根目录 _进行中 文件
5. 更新 四端未完成需求汇总.md
6. 更新 5、接口/开发进度_接口文档.md
7. 更新 已完成/README.md 表格一行
8. 禁止 git push（除非卡若本轮明确说提交）

脚本（可选）

python3 开发文档/1、需求/scripts/flatten_requirements.py
python3 开发文档/1、需求/scripts/reorganize_requirement_docs.py

---

六、开发前检查

1. 读 四端未完成需求汇总 + 本端唯一 _进行中
2. 读 _进行中 内 跨项目协调 表
3. 🔴/🟡 阻塞项在范围内 → 不整体验收
4. 对话列出：已读文档 ≤5 条 + COORD 状态
5. 确认 没有 第二份同端 MD

---

七、质量门禁

• 根目录无 *已完成* MD（总汇只在 已完成/ 子夹）
• 每端 ≤1 个 _进行中 在根目录
• 无 {项目}_{主题} 与 _进行中 并存（专文已合并或归档）
• 横表链接指向 _进行中 · 不链已删专文
• P0 块含：问题 / 根因 / 固定规则 / 验收
• 已完成批次在 已完成/{项目}_{主题}_{date}/ 且图片不断链
• 修改/README.md 与 已完成/README.md 已更新

---

八、与卡若AI 分工

Skill	职责
卡若AI W05b 需求整理	通用落盘 → 本项目用 开发需求文档整理
卡若AI W05c 需求协调	共享 COORD → 本项目用 本文
开发需求文档整理	录屏→全量 MD · Obsidian 配图
本文（0530）	一项目一文件 · 已完成下沉 · 关单分拣 · 维护期模板

---

九、延伸阅读

• 修改/README.md
• 已完成/README.md
• 四端对接铁律
• 跨项目协调索引