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