AI Skill 大全

项目文档修改

对 Supabase 文档仓库里已有的页面做精简改写和结构重排,按每种改动类型分 commit,输出一个便于评审的 PR。

功能与用途

文档页读起来绕、章节顺序别扭,改动一提交却没人看得懂——因为一个 diff 里混着改写、搬动和纠错三种东西,评审分不清哪句是移动哪句是重写。这个 Skill 强制把改动按类型切开:风格类只做行内改写,结构类才动章节顺序,技术说法的纠错必须单独成 PR 并用代码取证。重排之前它会先 grep 全仓,把被产品按钮深链引用的标题锚点锁死——移动章节和改层级都不影响锚点,只有改名才会断链。篇幅远超预估时它也不会擅自拆分,而是停下来把选择权交给评审方。

适用场景

  • 某个 guide 页面背景介绍插在步骤中间,读者照着做总被打:某个 guide 页面背景介绍插在步骤中间,读者照着做总被打断,需要重排但怕弄断锚点链接
  • 一个 PR 里同时改了措辞和搬了章节,评审说看不懂,需要重做:一个 PR 里同时改了措辞和搬了章节,评审说看不懂,需要重做成按改动类型分的提交
  • 页面上的图片 alt 文本只写了主题词,和旁边的小标题重复,:页面上的图片 alt 文本只写了主题词,和旁边的小标题重复,需要逐张打开重写

适用人群

  • 开源项目技术文档工程师
  • Supabase 文档贡献者
  • 开发者关系内容维护人员

使用步骤

  1. 指定要改的页面和改动意图,它先通读目标页和同类邻近页,判定文档类型和读者目标
  2. 它把诊断结果分到风格、结构、技术纠错三类,明确哪几类是空的并说明原因
  3. 风格类先做:统一人称时态、把步骤改成流程格式、逐张打开图片重写 alt 文本、按词表清理术语
  4. 结构类在做之前先用 grep 锁定被深链引用的标题,把章节按读者动作分类后再重排并补交叉引用
  5. 提交前它给出篇幅估算,如果超出阈值会提议拆成堆叠 PR 并等你确认,未确认则输出单个 PR

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
办公
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
专业
版本
master
最近更新
2026-09-17
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

>-

使用前准备

  • 需要熟悉 Supabase 文档仓库结构、CONTRIBUTING.md 与 WORD_LIST.md 规范,并会使用 git 分支与 PR 流程

依赖与权限

  • 读取用户主动提供的内容

同类 Skill