req-intake

# 需求受理（req-intake） 需求跟丢，多半丢在第一步：一句话在群里提了，没有文档，没有工作项，也没人写下"做成什么样算成"。这一步我们只做三件事：问清值不值得做，写下可验证的预期效果，把文档和工作项建出来并互相挂上。提出人是这个需求的 TPM，Agent 是他的搭档，不是替他拍板。 ## 1. 先挑战，再记录 按下面顺序问提出人，答不上来的写进文档「待确认问题」，不替他编： 1. **谁在什么场景下遇到什么问题？** 要一个真实例子（会话、截图、工单、数据），没有例子就标「无实证」。 2. **不做会怎样？** 现在怎么绕过去的，绕过去的代价是什么。 3. **有没有更小的做法？** 改文档、改配置、已有功能就能解决的，直接建议不立需求。 4. **和谁有关？** 需求方、可能的执行人、要通知的人。 结论只有三种：立项 / 建议不做（附原因，提出人确认后关闭） / 先补信息。 ## 2. 写预期效果（Expected Outcome） 这是整条链路最后验收的依据（`req-outcome` 会回来对它）。每条必须同时有： | 项 | 例子 | | --- | --- | | 指标或可观察行为 | `/resume` 列表首屏加载 P95 | | 基线（现在的值，带来源） | 2.4 s，来自上周埋点 | | 目标 | ≤ 800 ms | | 怎么测、谁来测 | 同一埋点，上线后 7 天窗口，提出人看 | | 观察窗口 | 上线后 7 天 | 写不出基线就先写「基线待测」和测法，不允许只写「体验更好」「更稳定」。 ## 3. 建飞书需求文档 用 `templates/requirement-doc.md` 填好后创建（Markdown 导入）： ```bash lark-cli docs +create --as user --doc-format markdown \ --title "【需求】<一句话标题>" --content @req.md \ [--parent-token <需求文件夹或 wiki 节点 token>] ``` 记下返回的文档 URL。 ## 4. 建 Meegle 工作项并互链 ```bash meegle workitem meta-create-fields --project-key <PK> --work-item-type <类型 key> --format json meegle workitem meta-roles --project-key <PK> --work-item-type <类型 key> --format json meegle workitem create --project-key <PK> --work-item-type <类型 key> \ --fields '[{"field_key":"name","field_value":"<标题>"},{"field_key":"<需求文档链接字段>","field_value":"<文档 URL>"}]' \ --format json ``` - 模板 ID 是必填项（meegle skill 原文），从 `meta-create-fields` 里取。 - 「需求文档链接」字段的 key 未核实，见字段映射文档；没有专门字段时，把链接写进 `description`。 - 回写文档「1. 文档信息」里的工作项链接： ```bash lark-cli docs +update --as user --doc <文档 URL> --command str_replace \ --pattern "工作项：待创建" --content "工作项：<Meegle 链接>" ``` ## 5. 验收这一步 - `meegle workitem get --project-key <PK> --work-item-id <ID> --format json` 能读回标题和文档链接。 - `lark-cli docs +fetch --as user --doc <URL> --keyword "工作项"` 能看到 Meegle 链接。 - 预期效果表每一行都有基线（或测法）和观察窗口。 ## 输出 给提出人一张卡片：结论、预期效果表、文档链接、工作项链接、待确认问题。下一步通常是 `req-prioritize`。 ## 用到的命令 先确认身份和空间（每个会话一次）： ```bash meegle project search --project-key "<空间名或 key>" --format json meegle workitem meta-types --project-key <PK> --format json lark-cli docs +fetch --as user --doc <需求文档 URL> --scope outline ``` 字段 key、状态 key、transition_id 一律现查，不要凭记忆填，见 `templates/meegle-field-mapping.md`。