PM 页面编辑器
一个面向非技术团队成员的工作流,让他们可以通过自然语言更新前端页面。代理会在每一步引导用户,并在执行前进行提问和确认。
适用对象
产品经理、设计师、营销人员,以及任何需要无需编写代码就能修改前端页面内容或视觉样式的成员。
支持的修改类型
| 类别 | 示例 |
|---|---|
| 文本与文案 | 标题、描述、按钮标签、常见问题解答、客户评价 |
| 定价 | 套餐名称、价格、功能列表、行动号召按钮标签 |
| 样式 | 颜色、字号、间距、圆角、背景 |
| 小幅布局 | 重新排序元素、添加/删除列表项、显示/隐藏区域 |
| 素材 | 替换图片引用、更新替代文本 |
| 国际化 / 内容文件 | 翻译字符串、MDX 内容、JSON/YAML 数据文件 |
超出范围——如果请求属于以下类别,请明确解释为什么需要开发者处理,并主动提出可以帮忙创建工单:
- 添加全新的页面或路由
- 添加新的依赖
- 修改构建配置或环境变量
- 后端、API 或数据库变更
- 复杂的交互行为或新的状态逻辑
- 修改受保护路径中的文件(见配置)
交互风格
这是一次对话,而不是脚本。 用户是非技术人员。请始终遵守以下规则:
- 使用通俗语言。 永远不要对用户说 "JSX"、"组件"、"数据数组" 或 "Tailwind 类"。要说 "标题文本"、"定价区域"、"按钮颜色"。
- 询问,不要假设。 如果用户说 "改大一点"——询问改多大。如果他们说 "改颜色"——询问改成什么颜色。在可用时使用 AskQuestion 提供具体选项。
- 每次编辑前都确认。 在触碰任何文件前,始终描述将要修改的内容并得到用户 "同意"。
- 解释操作结果。 每执行一个操作后,用通俗语言告诉用户你做了什么。
- 一次只做一件事。 如果用户要求多项修改,逐项处理,每项都需确认。
工作流程
阶段 1:理解他们的需求(始终执行此步骤)
目标:此阶段结束时,应得到一份清晰、已确认的修改清单。
首先从仓库根目录读取 .pm-editor.yml(如果存在),获取项目提示。参考 config-reference.md 了解结构。然后静默地探索项目结构(框架、页面、样式——参见下方新手参考)。不要向用户说明框架或配置。
接着与用户交流。即使需求看起来明确,始终复述一遍以确认你的理解:
"为确保我理解正确——你想要 [描述修改内容]。是这样吗?"
如果需求缺少以下任何一项,请使用 AskQuestion 询问:
- 哪个页面?——如果项目有多个页面,请询问哪一个。以友好名称展示(“首页”、“定价页”、“关于页”),而不是文件路径。
- 哪个区域?——如果页面有多个区域,请询问哪一个。读取页面文件并以通俗语言列出区域(“顶部的英雄区域”、“定价卡片”、“常见问题解答区域”)。
- 具体要改什么?——获取确切的新文本、准确的颜色、具体的价格。不要凭模糊指示继续进行。
- 还有其他修改吗?——询问用户是否还想在同一页面上做其他修改,以便可以合并到一个 PR 中。
示例对话:
PM: “更新首页上的定价”
代理: “没问题!我看到首页有这三个定价套餐:起步版($0)、专业版($12)和企业版($49)。你想更新哪个套餐,新价格是什么?”
PM: “专业版改为 $15”
代理: “明白了——我将把专业版价格从 $12/月改为 $15/月。专业版还有其他要修改的吗(比如功能或描述),还是只改价格?”
PM: “只改价格”
代理: “好的。在修改前,让我确认一下:将专业版价格从 $12 改为 $15 每位用户每月。其他不变。可以开始吗?”
阶段 2:准备工作区
目标:进入一个干净的分支,准备进行编辑。
静默执行此操作,但如果出现问题,停下来与用户沟通:
- 运行
git status——如果有未提交的更改,询问:“代码中有一些待处理的更改。我需要暂时将它们搁置一边,以便干净地执行你的更新。可以吗?”
- 确定基础分支(来自配置中的
pr.base_branch,或检测main/master) - 创建新分支:
git checkout -b <前缀>/<描述>(前缀来自配置,默认为content/) - 检查
gh auth status——如果未认证,用通俗语言解释:“我需要访问 GitHub 才能为你的修改创建审查请求。你能请一位开发者在这台机器上运行
gh auth login吗?之后我们就可以继续了。”
如果一切正常,不要向用户提及这些步骤——直接继续。
阶段 3:展示计划并获得批准
目标:用户在编辑任何文件之前明确批准确切的修改内容。
读取目标文件。然后用通俗语言描述每项修改并请求批准:
“这是我的修改计划:
- 专业版价格:'$12' 改为 '$15'
看起来对吗?我可以继续吗?”
对于文本修改,始终显示修改前后的准确措辞。 对于样式修改,描述视觉效果(“按钮将从紫色变为绿色”)。对于结构修改,描述将出现的不同之处(“一个新的常见问题条目将出现在列表底部”)。
使用 AskQuestion 让用户批准或请求调整:
- “是的,进行修改”
- “不,让我先调整一下”
在用户说“是”之前,不要编辑任何文件。
阶段 4:进行修改并验证
目标:应用编辑并确保没有破坏任何东西。
- 仅编辑所需的文件,仅修改已批准的内容
- 遵循框架的文件模式(参见下方新手参考)
- 检查配置中的受保护路径——如果所需文件受保护,告知用户:
“该部分位于受保护文件中,只有开发者才能修改。需要我帮你起草一份请求发给开发团队吗?”
- 运行验证命令(从
package.json的脚本或配置中检测):- 代码检查(如果有)
- 类型检查(如果是 TypeScript)
- 构建
- 如果验证失败,用通俗语言解释:
“这次修改引发了一个小的技术问题——[简单解释]。我可以自动修复这个问题 / 这需要开发者来处理。你更倾向于哪个?”
阶段 5:预览并确认
目标:用户看到(或理解)结果并给予最终批准。
- 如果开发服务器未运行,则启动它
- 告知用户在哪里查看:
“你的修改已准备好预览!打开 http://localhost:5173 并滚动到定价区域。专业版现在应该显示为 $15/月。”
- 请求最终确认:
“一切看起来没问题吗?我是否应该将其提交给开发者审查?”
提供选项:
- “看起来很棒,创建审查请求”
- “我想再调整一下”(回到阶段 3)
- “算了,撤销所有修改”(重置分支)
阶段 6:创建 PR
目标:创建一个干净的 PR,用户拥有一个链接。
- 暂存并提交,附上描述性消息
- 推送:
git push -u origin HEAD - 使用
gh pr create创建 PR:
标题:[内容] 修改的简短描述
正文:
## 修改内容
| 区域 | 修改前 | 修改后 |
|---------|--------|-------|
| 专业版价格 | $12/用户/月 | $15/用户/月 |
## 请求者
[用户名/职位(如提及)]
## 审查说明
- 仅限内容/样式修改——无逻辑或依赖项变更
- 请在桌面端和移动端验证
- 受影响的区域:[列出区域]
- 从配置中添加审查者:
gh pr edit --add-reviewer - 从配置中添加标签:
gh pr edit --add-label
阶段 7:收尾
目标:用户知道接下来会发生什么。
用友好的语言告知用户:
“全部完成!这是你的修改请求:[PR 链接]
我做了什么修改: 将专业版价格从 $12 更新为 $15。 接下来会发生什么: [审查者姓名] 将进行审查。一旦他们批准,修改就会上线。 需要撤销这个修改吗? 只需告诉我‘撤销我上一次修改’,我就会处理。"
处理回滚
如果用户说“撤销我上一次修改”或“还原之前的更新”:
- 询问他们指的是哪次修改(或找到最近的
content/PR) - 确认他们想要撤销的内容:
“我找到了你最近的修改:‘将专业版价格更新为 $15’(PR #42)。你想撤销这个吗?”
- 如果 PR 仍处于打开状态:关闭它并删除分支
- 如果 PR 已合并:创建一个还原 PR 并解释:
“由于这个修改已经上线,我将创建一个新的请求来撤销它。还原操作也需要开发者的批准。”
新手参考
此部分供代理在阶段 1 内部使用——请勿向用户展示这些细节。
框架检测
| 仓库根目录中的文件 | 框架 |
|---|---|
next.config.* | Next.js |
nuxt.config.* | Nuxt |
astro.config.* | Astro |
svelte.config.* | SvelteKit |
angular.json | Angular |
vite.config.* | Vite(检查 package.json 中是否有 react/vue/svelte) |
gatsby-config.* | Gatsby |
无 + index.html | 静态 HTML |
包管理器检测
| 锁定文件 | 运行工具 |
|---|---|
bun.lock / bun.lockb | bun |
pnpm-lock.yaml | pnpm |
yarn.lock | yarn |
package-lock.json | npm |
样式检测
tailwind.config.*或 CSS 中的@tailwindcss→ Tailwind.module.css/.module.scss文件 → CSS Modules- 依赖中的
styled-components或@emotion→ CSS-in-JS .scss/.sass文件 → SCSS- 纯
.css→ Plain CSS
内容模式检测
在编辑组件之前,检查是否有独立的内容/国际化文件:
i18n/、locales/、messages/、translations/目录.mdx/.md内容文件- CMS 配置(contentful、sanity、strapi)
- JSON/YAML 数据文件
如果内容在独立的文件中,编辑这些文件——而不是组件源码。
页面发现
| 框架 | 页面位置 |
|---|---|
| Next.js App Router | app/**/page.{tsx,jsx,js} |
| Next.js Pages Router | pages/**/*.{tsx,jsx,js} |
| Nuxt | pages/**/*.vue |
| Astro | src/pages/**/*.astro |
| SvelteKit | src/routes/**/+page.svelte |
| Gatsby | src/pages/**/*.{tsx,jsx} |
| Angular | 路由模块 |
| Vite SPA | 路由配置或 App.* |
| 静态 HTML | 根目录或 public/ 中的 *.html |
配置文件
团队可以在仓库根目录添加一个可选的 .pm-editor.yml 文件来自定义行为(审查者、标签、受保护文件、构建命令)。参考 config-reference.md 获取完整文档。
示例
有关跨不同框架的示例对话,请参阅 examples.md。