产品营销、API 产品与开发者关系先在 Work 确认价值主张、用例和 CTA,设计与开发随后在 IDE 检查组件、链接与多端呈现。
TRAE × 内容与创意 · 可处理 3/4 个环节
TRAE × API 产品介绍页策划 Skill
API 产品介绍页策划 Skill有 4 个执行步骤,TRAE 可以处理 3 步,其中 3 步需要相应工具与配置。它能直接读取本机目录里的资料,正好对应这个 Skill 里最吃工具的一段。需要提前知道的是:中文办公文档这 1 项它不做,涉及的 1 个步骤要按下面的手工方式衔接。
- 4个核心环节
- 3/4当前可处理的环节
- 未进前十在本 Agent 的推荐清单
WHY TRAE
适配结论
TRAE 适合把 API 产品介绍页策划放进官网改版项目
API 产品介绍页策划 Skill可以作为独立任务在 TRAE 中使用。具体适配方式、资料交接和需要人工确认的环节见下方说明。
TRAE 适合把 API 产品介绍页策划放进官网改版项目。编辑先在 Work 整理读者、价值主张、用例和 CTA,再到 IDE 将批准稿关联到现有页面组件和文档链接,在本地预览桌面与手机呈现。
CAPABILITY × STEP
核心差异
Work 内容策划与 IDE 多端页面预览
API 产品介绍页策划 Skill 共 4 个环节。TRAE 可以处理 3 个环节,其中 3 个需要相应工具与配置;另外 1 个需要团队补充。实际结果取决于输入资料、已接入工具与运行环境。
| 步骤 | 所需能力 | 等级 | 在 TRAE 下具体怎么做 |
|---|---|---|---|
| 01 确认 API 类型、页面读者与文档位置 | 读本地资料打开网页取正文中文办公文档 | 需手工 | 改成手工:先把办公文档另存为 Markdown 或纯文本。(办公文档要先转成文本或 Markdown) |
| 02 提炼价值主张、核心能力与典型用例 | 读本地资料写本地文件产物区审阅 | 有条件 | 可以做但有条件:TRAE 对产物区审阅的支持有限制。 |
| 03 安排快速开始、认证概览、SDK 与 CTA | 读本地资料写本地文件打开网页取正文产物区审阅 | 有条件 | 可以做但有条件:TRAE 对产物区审阅的支持有限制。 |
| 04 完成 API SEO 元数据与内部链接 | 写本地文件产物区审阅打开网页取正文 | 有条件 | 可以做但有条件:TRAE 对产物区审阅的支持有限制。 |
API 页面进入实现后,常出现代码块溢出、SDK 卡片拥挤、文档 CTA 不清或手机端区块顺序失效。TRAE 可以在同一项目中保存策划稿与组件资料,预览现有实现的多端呈现。
- 01
确认 API 类型、页面读者与文档位置
在 Work 中读取产品资料、现有页面和改版 Brief,确认 API、读者与文档入口。
- 02
提炼价值主张、核心能力与典型用例
整理 H1、副标题、核心能力和用例,交给产品营销与技术负责人确认。
- 03
安排快速开始、认证概览与 CTA
根据现有组件列出区块顺序、文案、如有的 SDK、文档链接、CTA 与仍需确认的内容。
- 04
完成 API SEO 元数据与内部链接
在 IDE 关联批准稿与当前组件,检查元数据、Schema 候选字段、多端预览和关键链接。
IMPORT · RUN
资料导入与任务下发
导入 Skill 并加入网站项目
TRAE可以直接读取目录里的资料,把这些文件放在同一个位置即可。
需要准备的资料
- API 类型、产品能力、目标行业、典型集成场景,以及开发者和技术决策者各自关心的问题
- 现有 API 页面 URL、截图或页面稿,开发文档、API Reference、快速开始与注册入口
- 认证方式、如适用的公开价格与使用限制、如有的 SDK 与工具清单,以及已经确认的示例和产品术语
- 品牌语气、目标产品词或行业 API 关键词、首页与功能页链接、SEO 和结构化数据要求
在 TRAE 里是这样推进的
研究和写作任务可以在 TRAE Work 中准备资料;落地页、网站和程序化 SEO 项目放进 TRAE IDE。
导入 Skill 后,可以创建研究、文案、设计和开发角色分工完成,再用 MCP 读取已授权的数据和资料。
在 Skills 设置中导入技能目录,或放入项目级 Skills 目录,再提供改版 Brief、产品资料、API 页面路径、文档链接、组件、样式与预览命令。
MANUAL HANDOFF
需要团队补充的步骤
中文办公文档需要手工补
有 1 项能力需要你在 TRAE 之外完成,下面写清了各自影响哪一步、怎么补。
-
中文办公文档
影响:第 1 步 确认 API 类型、页面读者与文档位置
原因:办公文档要先转成文本或 Markdown
做法:先把办公文档另存为 Markdown 或纯文本
COLLABORATE · CHAIN
协作与后续衔接
Work 审内容,IDE 看桌面与手机呈现
批准稿与网站项目保持关联
选定的页面结构、文案、技术资料、文档入口、元数据和 Schema 建议保留在项目中,供设计与开发继续实现。
COMBINATION CASE
场景化实战案例
示例:新增 SaaS API 产品介绍页
假设官网已有 Hero、功能卡片、SDK 卡片和 CTA 组件,团队希望增加 API 页面并连接现有文档。
- 在 Work 整理资料
- 确认价值主张与用例
- 排列页面区块
- 进入 IDE 关联组件
- 预览桌面与手机页面
预期结果:交付批准稿、区块与组件对照和多端预览检查表;此为假设场景,API 验证、页面修改和正式发布需要继续确认。
VERIFY · TROUBLESHOOT
效果验证方法
打开代表性宽度检查 H1、CTA、用例、SDK、代码或终端示意、文本换行、文档链接与资源加载
打开代表性宽度检查 H1、CTA、用例、SDK、代码或终端示意、文本换行、文档链接与资源加载。
可直接使用的第一个任务
请在 TRAE 中使用「API 产品介绍页策划 Skill」。本次要完成:SaaS 产品已经开放 REST API,官网只有端点文档,潜在客户看不出适用场景和接入价值。我会提供API 类型、产品能力、目标行业、典型集成场景,以及开发者和技术决策者各自关心的问题和现有 API 页面 URL、截图或页面稿,开发文档、API Reference、快速开始与注册入口。请先完成一份小样,交付API 产品介绍页结构:价值主张、核心能力、使用场景、快速开始、认证概览,以及如适用的价格或限制、如有的 SDK 或工具和关键文案:H1、副标题、核心能力说明、典型用例,以及通往开发文档或注册入口的 CTA,并列出需要我确认的金额、日期、适用人群和目标链接。注意:中文办公文档这部分你做不到,遇到时直接告诉我,我手工补。
安装后的最小验证任务
安装完成后,请 TRAE 读取这份 Skill 与已提供的输入资料,复述本次任务,并列出缺少的材料。只返回核对结果,不修改文件或网页。
TRAE 常见问题
- 没有调用 Skill 时,在 Skills 设置中确认已经启用
- 项目级 Skill 未出现时,检查 .agents/skills 目录
- 页面结果不合适时,打开预览并指出具体区块和屏幕尺寸
- 第 1 步 确认 API 类型、页面读者与文档位置停住时,不用反复换提示词——办公文档要先转成文本或 Markdown,按上面的手工方式补这一步即可
- 产物区审阅相关步骤结果不稳定时,先确认当前环境是否满足条件
TRAE 跑API 产品介绍页策划 Skill需要改哪几步?
4 个环节里有 3 个可以处理,其中 3 个需要相应工具与配置,1 个需要团队补充。请结合逐步说明确认实际做法。
资料要怎么交给 TRAE?
TRAE可以直接读取目录里的资料,把这些文件放在同一个位置即可。
装完先做什么验证?
安装完成后,请 TRAE 读取这份 Skill 与已提供的输入资料,复述本次任务,并列出缺少的材料。只返回核对结果,不修改文件或网页。
什么任务更适合选 TRAE?
TRAE 适合把 API 产品介绍页策划放进官网改版项目。编辑先在 Work 整理读者、价值主张、用例和 CTA,再到 IDE 将批准稿关联到现有页面组件和文档链接,在本地预览桌面与手机呈现。
TRAE 常见的失败情况有哪些?
没有调用 Skill 时,在 Skills 设置中确认已经启用;项目级 Skill 未出现时,检查 .agents/skills 目录;页面结果不合适时,打开预览并指出具体区块和屏幕尺寸。
先核对一版文案与现有组件
先完成内容审阅并确认现有组件能承载用例、SDK 与 CTA,再扩展新组件或更多页面状态。
API 能力、认证方式、价格、限额、SDK、工具、支持范围、示例和所有 CTA 去向都要由产品与技术团队确认。策划完成后,API 开发、端点文档、接口测试、网页实现、埋点和正式发布继续由对应团队处理。
INSTALL
安装到 TRAE
把API 产品介绍页策划 Skill装进 TRAE,点几下完成
在 Skills 设置中导入技能目录,或放入项目级 Skills 目录,再提供改版 Brief、产品资料、API 页面路径、文档链接、组件、样式与预览命令。
METHOD 01 · 交给 AI 自己装
复制提示词
适合大多数情况。Agent 会下载 ZIP、解压、放到正确目录,并在缺少权限时告诉你需要手工做哪一步。
请帮我把「API 产品介绍页策划 Skill」安装到 TRAE。 1. 下载完整 Skill ZIP:https://www.vibemarketing.work/packages/skill-api-page/1.0.0/skill-api-page.zip 注意:网页 HTML 不能当作 Skill 文件安装,必须使用 ZIP 里的完整文件。 2. 解压后保留 SKILL.md 及全部配套文件,按 TRAE 的方式安装:在 Skills 设置中导入包含 SKILL.md 的 skill-api-page 目录;项目级 Skill 可放入 .agents/skills/skill-api-page 3. 安装完成后告诉我实际安装目录。 4. 用一个只读小任务验证:在 Skills 设置里确认已启用,再让它对一个页面或一份材料做只读检查。 5. 如果你没有联网、下载或写目录权限,请直接告诉我哪几步需要我手工完成。 参考:原始 SKILL.md https://www.vibemarketing.work/raw/skill-api-page/SKILL.md;安装指南 https://www.vibemarketing.work/agent-install/skill-api-page.md
METHOD 03 · 手动放目录
手动安装
解压 ZIP 后,在 TRAE 中执行:
在 Skills 设置中导入包含 SKILL.md 的 skill-api-page 目录;项目级 Skill 可放入 .agents/skills/skill-api-page
验证:在 Skills 设置里确认已启用,再让它对一个页面或一份材料做只读检查。
- 项目级 Skill 未出现时检查 .agents/skills 目录
- 页面结果不合适时打开预览并指出具体区块和屏幕尺寸
HTML 业务页面不能直接当作 Skill 文件安装。AI 需要下载完整 ZIP 并保留配套文件。
OTHER AGENTS
跨 Agent 适配对比
WorkBuddy、Codex在这个 Skill 上覆盖更多环节
下面的步数来自逐步比对。卡在哪一步,就看哪个 AI 能直接完成那一步。
WorkBuddy API 产品介绍页策划
WorkBuddy在这个 Skill 上直接覆盖 4/4 步,而且能直接读写 Word、Excel、PPT 等办公文档——如果你这次的卡点正是中文办公文档,换它更省事。
Codex API 产品介绍页策划
Codex在这个 Skill 上直接覆盖 3/4 步,而且能在独立产物区里逐份审阅和修改交付物——如果你这次的卡点正是产物区审阅,换它更省事。
FURTHER READING
TRAE 与API 产品介绍页策划相关的实操文章
继续查看这套 API 产品介绍页策划方法:先区分开发者与技术决策者,再组织价值主张、用例、快速开始和文档入口,最后补齐开发者 SEO 与内部链接。
假设一家 SaaS 公司上线了 ROI 计算器。三个月后,工具页的自然流量和使用次数都在涨,市场团队把它当作新的获客入口,销售却说收到的邮箱很难跟进:有人只想算一道题,有人来自目标行业之外,还有人留下
定价页已经把 Starter、Professional、Enterprise 排成三张卡,价格、功能和“最受欢迎”角标也都在,销售仍然反复收到同一个问题:我们该买哪一档?这时团队很容易删一档套餐、放大
假设一家 SaaS 公司把官网从六个一级栏目收成“产品、解决方案、资源”三个下拉菜单。价格页和文档页仍在,只是从页头可见入口移到了第二层。改版后如果销售频繁收到“有没有公开价格”“API 文档在哪里”
买家搜索“A 对比 B”时,通常已经知道品类,也看过其他产品。他打开供应商的对比页,看到自家产品每一行都是绿色勾,竞品则处处受限;再打开竞品的网站,结论正好反过来。两张页面都写了很多功能,却没有帮助他
越来越多人把选型直接丢给ChatGPT、Perplexity、Gemini,或者购物、采购类助手。答案是模型拼出来的,不一定点开你的网页。世界经济论坛把这件事叫做智能体引擎优化(AEO):你要进的不是
市场部改官网,销售改话术,投放改广告,三边各自有一套说法,在不少团队里已经算日常。语气不同还能凑合用。客户听完三遍,仍然复述不出你们到底解决哪一件事,这才麻烦。功能清单越长,这句话越容易丢。产品营销要
NEXT WORKFLOW
搭配使用
导航站收录 Skill、海外社区搭建 Skill、营销对比表设计 Skill
API 产品介绍页负责概览、价值表达、使用场景和文档或注册入口;官网首页负责品牌主入口,功能页解释单项能力,开发文档与 API Reference 负责端点、参数、响应和代码示例。
TRAE 导航站收录 Skill
用 TRAE 完成「新产品准备在 Product Hunt 做首发」,最终得到带网址与收录状态的 CSV 跟踪表单。
TRAE 海外社区搭建 Skill
用 TRAE 完成「准备在 Slack 搭建早期种子用户群」,最终得到包含版块定位与发帖指南的频道架构表。
TRAE 营销对比表设计 Skill
用 TRAE 完成「竞品落地页需要说明产品差异,同时避免只挑选有利于自己的比较项」,最终得到区块方案:页面位置、对比类型、H2、引导语与单一 CTA。