PRODUCT MANAGER × AGENT

产品经理 Agent 协作开发指南

你负责说清需求、确认范围和验收结果；你的 Agent 负责准备环境、修改代码、验证并创建 PR。看懂步骤，把提示词复制给 Agent 即可开始。

你来确认需求目标、页面效果、是否可以上线

Agent 来执行同步代码、创建分支、开发、测试、提交 PR

第一步：先找负责人开通仓库协作权限

把你自己的 GitHub 用户名发给仓库负责人。收到邀请邮件后，点击 接受 GitHub 邀请。每个人使用自己的账号，不共享密码、Token 或密钥；没有权限时不要让 Agent 反复尝试。

开通 GitHub 协作权限

这一步由你和仓库负责人完成，Agent 不能代替授权。

你来做

注册或登录自己的 GitHub 账号，把用户名发给仓库负责人，并接受邀请。

负责人来做

在仓库 Settings → Collaborators → Add people 中添加你的账号。

收到邀请后必须点击接受；未接受前不会获得仓库协作权限，也无法提交任务分支。
如果提示没有权限，把报错截图和 GitHub 用户名发给负责人。
任何人都不需要把自己的账号密码交给其他人或 Agent。

让 Agent 完成首次准备

只需做一次。Agent 会检查工具、登录你的 GitHub 账号、下载仓库并验证环境。

首次准备提示词

我要参与生态线索产品项目开发，但我没有开发经验。请作为我的开发 Agent 完成首次环境准备。

仓库：https://github.com/guoxin533633-lab/demand-platform.git

请按顺序执行：
1. 检查当前电脑是否已安装 Git、Node.js 20 LTS、PowerShell 7 和 GitHub CLI；缺少时先说明并使用安全、官方的安装方式。
2. 使用我自己的 GitHub 账号完成登录。不要向我索要或输出密码、Token、私钥。
3. 检查我是否已接受该仓库的协作者邀请；若没有权限，停止并告诉我需要把 GitHub 用户名发给仓库负责人。
4. 将仓库克隆到清晰的本地目录，阅读根目录 AGENTS.md。
5. 执行 npm --prefix demand-platform ci 和 npm --prefix demand-platform run build。
6. 最后用非技术语言告诉我：环境是否准备成功、本地代码目录在哪里、以后如何把需求交给你。

本次只准备环境，不修改功能、不创建 PR、不合并、不发布。

每次开发前，先同步最新代码

产品经理填写需求，Agent 负责同步最新 main、创建独立任务分支并开发。

你来填写

要改什么、参考图或页面、哪些内容不能变、怎样算完成。

Agent 来执行

同步最新 main，创建独立任务分支，修改、构建、测试并创建 PR。

日常开发提示词

请在本地仓库中开发下面这项需求。开始前先阅读根目录 AGENTS.md，并确认当前仓库没有未处理的修改。

【需求目标】
（在这里写要实现什么）

【参考资料】
（粘贴页面链接、截图路径或需求文档）

【必须保持不变】
（在这里写不能影响的内容；没有可写“无”）

【验收标准】
（在这里写我看到什么结果才算完成）

执行要求：
1. 从 GitHub 同步最新 main。
2. 使用 scripts/task-workflow.ps1 创建独立任务分支和 worktree，不直接修改 main。
3. 修改前先用非技术语言告诉我计划和改动边界。
4. 只改正式源码，不改线上文件，不提交账号密码、Token、客户数据、构建产物或历史备份。
5. 完成后执行项目要求的构建和测试，检查 git diff 与 git status。
6. 创建清晰的 Git commit，推送任务分支并创建 PR，等待 CI。
7. 最后告诉我 PR 链接、改了什么、如何验收、CI 是否通过。

不要自行合并 PR、不要发布上线、不要清理分支；等待我确认。

查看 PR，用产品语言验收

PR 就是一份“待审核的改动申请”。你不需要逐行读代码。

先看改了什么

目标是否与需求一致，有没有把其他范围带进来。

再看实际效果

打开预览或本地页面，按验收标准逐项检查。

最后看 CI

CI 必须显示通过；失败时把结果交给 Agent 修复。

发现问题时，不要自己覆盖文件、强制提交或删除分支。描述现象并附截图，让 Agent 在同一个任务分支继续修改。

问题修复提示词

请继续处理当前 PR，不要新建重复 PR。

我验收时发现的问题：
（描述现象，并粘贴截图路径或报错）

我期望的结果：
（写清正确效果）

请先判断问题原因和影响范围，再在原任务分支修复。修复后重新执行构建和相关测试，更新原 PR，并用非技术语言告诉我：原因、修复内容、验证结果和我需要重新检查的地方。不要合并、不要发布。

验收通过后，明确确认上线

产品经理不直接操作服务器。合并和发布由仓库负责人或被授权的 Agent 完成。

统一确认语句

“PR 验收通过，CI 已通过，确认合并并发布上线。”

负责人合并 PR 后，必须从同步后的 main 使用固定发布脚本。
上线完成后，你只需打开真实用户入口，按验收标准再检查一次。
如果线上与预览不一致，截图并反馈，不要直接编辑线上页面。

遇到问题找谁

先识别问题类型，再把信息交给合适的人。

没有仓库权限、无法接受邀请把 GitHub 用户名和错误截图发给仓库负责人。

不知道改哪个文件、需求边界不清楚先和负责人确认需求，不让 Agent 猜测或扩大范围。

构建失败、CI 失败、代码冲突把完整报错交给 Agent 诊断；不要强推、覆盖或删除文件。

看不懂 Agent 的技术回复要求它改用产品语言说明“发生了什么、影响什么、需要你决定什么”。