docs-edit 是一个面向文档仓库的编辑技能，主要用于修改已存在的文档页面，或在已有开放 PR 的情况下直接修订该 PR 中的内容。它解决的问题是：代理被要求修改某个 PR 的措辞时，容易新建分支、提交改动并另开第二个 PR，从而干扰他人的工作。该技能要求把修改落到已经存在的分支上。
主要能力包括：按 PR 编号或 URL 检出该 PR 的 head 分支并使用普通 git checkout，不使用 -b 或 --no-track 创建新分支；支持在 PR 自身分支上创建 worktree，并在新 worktree 中运行 mise trust 以解决 Vale pre-commit 钩子因配置文件未受信任而失败的问题；处理跨仓库 PR 时使用 gh pr checkout 配置 fork remote，并确认推送权限；通过 gh pr diff 读取真实 diff，而不是依赖可能过时的本地 main 分支；依据实现源码核验事实，而不是依据其他文档页面的说法；检查相关页面是否存在矛盾、重复、缺失入口和导航位置问题；识别并避免手工编辑由生成器生成的文件；在指令与先前要求相反时先确认再执行；提交前运行 make lint_prose，必要时运行 make broken-links-with-anchors 和 make check-mdx；最后报告编辑所在分支、相关页面变更和未能核验的内容。
使用方式以命令行流程为主，涉及 gh pr view、git fetch、git checkout、git worktree add、gh pr diff、gh api、grep 以及 make 目标等命令。该技能强调保持编辑范围小，不随意重构、合并或拆分页面；不编造示例、字段名、UI 标签或策略细节；对无法核验的内容明确说明。PR 描述需按规则使用 Closes 或 Refs 关联 Linear 问题，并以一句平实的话披露 AI 参与，不使用徽章。
适用场景是维护文档仓库、修订已有 PR 中的文档、核对文档与源码一致性，以及处理相关页面之间的交叉链接和事实矛盾。限制包括：需要本地具备 git、gh、mise 等工具环境；跨仓库 PR 需要推送权限；生成文件不应手工编辑，应修改生成器或上游来源；新增、移动、重命名或删除页面应使用 add-docs-page，页面归属问题应使用 docs-restructure。具体安装方式、收费、价格和支持平台暂未提供。