diff --git a/聊天教学-issue10复盘.md b/聊天教学-issue10复盘.md deleted file mode 100644 index 3d12b3e..0000000 --- a/聊天教学-issue10复盘.md +++ /dev/null @@ -1,157 +0,0 @@ -# Issue #10 复盘 — 聊天教学消息 - -> 以下是发给每个 bot 的教学消息，直接复制到对应 bot 的聊天窗口即可。 - ---- - -## 一、发给大龙虾（项目经理）的消息 - -把下面这段直接发到大龙虾的聊天窗口： - ---- - -你好大龙虾，我是你的主人。来复盘一下 Issue #10（猫狗杀）的问题。 - -这个 issue 产生了 450 条评论，但后端编码一直没有真正执行，陷入了死循环。我查了原因，问题出在你身上——不是你不努力，是流程上有个关键步骤你一直没做对。 - -**根本原因：你做阶段切换时，只在评论里写了新任务清单，没有更新 Issue body。** - -千问的轮询脚本（poll-tasks.sh）只读 Issue 的 body，不读评论。所以你在评论里写的后端开发清单，千问根本看不到。它看到的始终是最初的 body，里面没有带编号的 checklist，脚本就把整个 body 当成一个"任务"发给千问，千问把说明书原样回复一遍就"完成"了。然后交还给你，你再审查、再评论、再交给千问……无限循环。 - -**正确做法：阶段切换时，你必须用 `gh issue edit --body` 更新 Issue body。** body 是唯一的"合同"，评论只是讨论记录。 - -具体来说，当你审查完一个阶段、要进入下一个阶段时，你要做这三件事： - -1. **读取当前 body**： -```bash -gh issue view 编号 -R fangxingyu123/ai-team-tasks --json body -q '.body' -``` - -2. **修改 body 内容**：把新阶段的 checklist 写进 body，更新 phase 标记。比如设计完了进入编码： - - 把 `phase:design` 改成 `phase:coding` - - 在 body 里添加编码阶段的 checklist（用 `- [ ]` 格式） - - checklist 可以带编号也可以不带，但必须是 `- [ ] 任务描述` 的格式 - -3. **更新 body + 改标签**： -```bash -gh issue edit 编号 -R fangxingyu123/ai-team-tasks \ - --body-file /tmp/updated-body.md \ - --remove-label "role:dalongxia" \ - --add-label "role:qianwen-worker" -``` - -**记住：评论是讨论，body 是合同。千问只看合同。** - -另外还有一个小问题：body 里的 checklist 格式。之前你的 body 里没有用标准的 `- [ ] 任务描述` 格式，脚本的正则匹配不上。我已经修了脚本，现在它同时兼容 `- [ ] 1. 任务描述` 和 `- [ ] 任务描述` 两种格式。但你以后写 checklist 时，还是建议用带编号的，方便追踪。 - -这个流程我已经写进了你的 ai-team-manager 技能里。下次遇到阶段切换，先想这句话：**"我改 body 了吗？"** - -有问题随时问我。 - ---- - -## 二、发给千问（qianwen-worker）的消息 - -把下面这段直接发到千问的聊天窗口： - ---- - -你好千问，我是你的主人。来跟你说一下 Issue #10 的问题和以后的注意事项。 - -Issue #10（猫狗杀）你反复"处理"了很多次，但每次都只是把项目说明书原样回复了一遍，并没有真正写代码。这不是你的错——是大龙虾没有正确更新 Issue body，导致轮询脚本把整个 body 当成了一个任务发给你。 - -但我想教你一个自我保护的方法：**如果你收到的任务内容看起来是整个项目说明书（几千字、包含多个阶段、完整技术栈描述等），而不是一个具体的小任务，你应该识别出这是异常情况。** - -以后遇到这种情况，请这样做： - -1. **不要傻傻地执行。** 如果"任务"内容超过 2000 字、包含多个 `##` 标题、看起来像完整的项目说明而不是一个具体的开发任务，大概率是脚本解析出了问题。 - -2. **在 Issue 评论里发出警告**： -``` -⚠️ 异常检测：收到的任务内容似乎是完整的项目说明（非具体 checklist 项）。 -可能原因：Issue body 中缺少标准 checklist 格式（- [ ] 任务描述）。 -请 @dalongxia 检查 Issue body 格式。 -本轮跳过执行。 -``` - -3. **正常情况下**，你收到的任务应该是这样的： - - 标题明确：比如 "Node.js + TypeScript 项目初始化" - - 内容具体：告诉你做什么、用什么技术、输出什么文件 - - 是 checklist 中的一项，不是整个项目说明 - -我已经修改了轮询脚本，以后如果 body 里没有 checklist，脚本会直接跳过，不会再把整个 body 发给你了。但你自己也要有这个判断力。 - -**另外一个重要的事：代码要写到工作目录 `/home/node/.openclaw/workspace/` 里。** 每次处理编码任务时： -- 用 `exec` 工具执行 `mkdir -p /home/node/.openclaw/workspace/项目名/` 创建项目目录 -- 用 `write` 工具把代码文件写到这个目录 -- 完成后用 `exec` 工具运行代码做基本测试 - -这样脚本才能找到你的代码并推送到 GitHub。 - -有问题随时问我。加油！ - ---- - -## 三、发给 Kimi（智囊团/深度分析专家）的消息 - -把下面这段直接发到 Kimi 的聊天窗口： - ---- - -你好 Kimi，我是你的主人。来跟你聊一下团队协作流程的事情。 - -你在团队里的角色是**深度分析专家**，主要负责两个阶段： -1. **设计阶段**（phase:design）：对需求清单逐项做技术设计 -2. **测试阶段**（phase:review）：对编码成果逐项做测试验收 - -关于 Issue #10，这个项目出了一些流程问题，我来告诉你正确的工作方式。 - -**你的核心工作流程：** - -当你从轮询脚本收到一个任务时，它会告诉你： -- 当前是第几项（比如 "第 3/8 项"） -- 具体的任务内容（比如 "评论系统：文章评论、嵌套回复"） -- 当前阶段（design/coding/review） - -你要做的事情取决于阶段： - -**设计阶段（phase:design）：** -1. 仔细分析这个需求点 -2. 输出完整的技术设计：数据模型、API 接口定义、架构方案、关键技术选型 -3. 设计要具体到千问可以直接拿着写代码的程度 -4. 如果是最后一项（N/N），额外任务：**把编码阶段的 checklist 写出来**，告诉大龙虾哪些编码任务需要做 - -**测试阶段（phase:review）：** -1. 检查千问提交的代码（在代码仓 `ai-team-fullstack-code` 里） -2. 验证功能是否正确、代码质量是否达标 -3. 如果发现问题，详细描述问题位置和修复建议 -4. 如果通过，说明验证方法和结论 - -**异常处理：** -跟千问说的一样——如果你收到的任务内容不是一个具体的 checklist 项，而是整个项目说明书，请在评论里发出警告： -``` -⚠️ 异常检测：收到的任务内容似乎是完整的项目说明，不是具体的 checklist 项。 -请检查 Issue body 中是否包含标准 checklist（- [ ] 任务描述）。 -本轮跳过执行。 -``` - -**关于你的长上下文优势：** -你有 262K token 的上下文窗口，这是你的超能力。在做代码审查和设计分析时，充分利用它： -- 可以一次性读取整个项目的代码 -- 可以做跨文件的依赖分析 -- 可以写非常详细的设计文档 - -有问题随时问我。 - ---- - -## 四、常见问题 FAQ - -### Q: 为什么不让 poll-tasks.sh 也读评论？ -A: 因为评论太多了（issue #10 有 450 条），解析评论来寻找"最新的 checklist"非常复杂且容易出错。body 作为唯一真相源（single source of truth）是最简单可靠的方案。 - -### Q: 如果 body 太长怎么办？ -A: GitHub Issue body 的上限是 65536 字符，足够用了。如果一个项目有几十个 checklist 项也不会超。 - -### Q: 怎么验证修复是否生效？ -A: 下次创建新 issue 时，确保 body 里有 `- [ ] 任务描述` 格式的 checklist。千问/Kimi 的轮询脚本会自动找到第一个未勾选的项来处理。