项目文档修改
对 Supabase 文档仓库里已有的页面做精简改写和结构重排,按每种改动类型分 commit,输出一个便于评审的 PR。
功能与用途
文档页读起来绕、章节顺序别扭,改动一提交却没人看得懂——因为一个 diff 里混着改写、搬动和纠错三种东西,评审分不清哪句是移动哪句是重写。这个 Skill 强制把改动按类型切开:风格类只做行内改写,结构类才动章节顺序,技术说法的纠错必须单独成 PR 并用代码取证。重排之前它会先 grep 全仓,把被产品按钮深链引用的标题锚点锁死——移动章节和改层级都不影响锚点,只有改名才会断链。篇幅远超预估时它也不会擅自拆分,而是停下来把选择权交给评审方。
适用场景
- 某个 guide 页面背景介绍插在步骤中间,读者照着做总被打:某个 guide 页面背景介绍插在步骤中间,读者照着做总被打断,需要重排但怕弄断锚点链接
- 一个 PR 里同时改了措辞和搬了章节,评审说看不懂,需要重做:一个 PR 里同时改了措辞和搬了章节,评审说看不懂,需要重做成按改动类型分的提交
- 页面上的图片 alt 文本只写了主题词,和旁边的小标题重复,:页面上的图片 alt 文本只写了主题词,和旁边的小标题重复,需要逐张打开重写
适用人群
- 开源项目技术文档工程师
- Supabase 文档贡献者
- 开发者关系内容维护人员
使用步骤
- 指定要改的页面和改动意图,它先通读目标页和同类邻近页,判定文档类型和读者目标
- 它把诊断结果分到风格、结构、技术纠错三类,明确哪几类是空的并说明原因
- 风格类先做:统一人称时态、把步骤改成流程格式、逐张打开图片重写 alt 文本、按词表清理术语
- 结构类在做之前先用 grep 锁定被深链引用的标题,把章节按读者动作分类后再重排并补交叉引用
- 提交前它给出篇幅估算,如果超出阈值会提议拆成堆叠 PR 并等你确认,未确认则输出单个 PR
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 办公
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- master
- 最近更新
- 2026-09-17
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
>-
使用前准备
- 需要熟悉 Supabase 文档仓库结构、CONTRIBUTING.md 与 WORD_LIST.md 规范,并会使用 git 分支与 PR 流程
依赖与权限
- 读取用户主动提供的内容