MDXG Redline — md-review 人工审阅回路技能
让 AI 生成的 Markdown 交给真人画线批注，再以结构化 JSON 回流给代理，自动完成一轮完整的人机共审流程。
脚本仅生成HTML并轮询文件，范围最小；清理命令采用模拟运行设计，需显式 --yes 确认；权限封装在两个包装器前缀内且文档明确说明了权限逻辑。扣分项：npm 的 npx 依赖在运行时引入未固定的供应链风险，未经用户确认自动启动浏览器，清理权限规则（--clean --yes）为破坏性操作，且发布者未经核实（仅凭原因，非扣分项）。
SKILL.md 文档记录了详尽的故障模式（无头浏览器、Chromium 专用 API、超时处理、sourceLine 偏移回滚），两个包装脚本连贯，附带 evals.。扣分项：静态审查无法运行关键路径，evals 需要人工评审员介入，wait-feedback.sh 未验证文件路径有效性，npx 获取失败时的错误反馈未记录。
明确的用/不用边界，精确的触发模式（自动、斜杠命令、自然语言），记录了浏览器兼容性限制。扣分项：核心函数依赖 npx/npm 注册表，这在主大陆可能难以访问，未声明中文支持（文档为英文/日文），工作流本质上需要人工评审员在场，这限制了可用范围。
分层良好的文档（工作流、原理解析、故障排除、权限示例），MIT 许可证存在，dependency/eval 文件一致。扣分项：范围内未展示 CHANGELOG 或版本历史记录，包装器路径假设与 .claude/settings.local. 前缀匹配，这是一种脆弱的、依赖安装的工具约定，且未披露长期维护承诺。
端到端循环（生成 → 评审 → 应用评论）逻辑连贯，且有原则的应用策略（修正 vs 问题 vs 冲突），相比手动 CLI 操作有真正的边际价值。扣分项：静态审查无法验证输出是否按描述工作；应用评论依赖于 Claude 的判断质量，而非确定性的转换；与评审员的往返需要人工耐心等待，可能限制实际采纳率。
存在 evals. 和具体的评估文件，CI 工作流运行 check/test/build，原理解析解释了设计选择。扣分项：静态审查无法运行 evals，提供的 evals 是手动构建的 fixtures 而非自动通过的测试，仓库内的测试套件未显示覆盖了技能自身的包装脚本，无第三方执行证据。
- 静态审查，未执行；所有分数均为低置信度评估。
- 运行时依赖 npx 从 npm 注册表获取 mdxg-redline，在中国大陆网络环境下可能失败；建议提前本地安装。
- Write feedback. 仅支持 Chromium 系浏览器；Safari/Firefox 用户需使用导出/复制备选方案。
- --clean --yes 为破坏性删除，使用前应先执行模拟运行确认候选文件。
- 工作流需要人工评审员在浏览器端操作，评论应用依赖 Claude 的解释判断，批量应用前应核对。
- 发布者未经 FollowSkills 企业注册库验证，身份未知。
这个 Skill 能做什么，适合哪些场景？
MDXG Redline 是一个纯浏览器端（单文件 HTML）的 Markdown 批注工具，可将人工审阅意见导出为带 headingPath 和 sourceLine 的结构化 feedback.。配套的 md-review 技能把这个回路端到端自动化：生成审阅 HTML、后台轮询反馈文件、把逐条批注应用到 Markdown 并发起下一轮。它实现了 MDXG Viewer（只读渲染规范）的绝大部分 MUST/SHOULD 条目，是 vercel-labs/mdxg 的第三方实现。适合任何需要真人把关 AI 生成文档的工作流。
运行 npx mdxg-redline <input.md> 生成 <名称>-<docHash>-review.html 并自动打开浏览器；等待审阅人在浏览器中选中文字批注并点击 Write feedback.（File System Access API）；通过 wait-feedback.sh 以 5 秒间隔、30 分钟超时后台轮询 feedback.；解析 comments[]，先用 sourceLine 定位、再用 quote grep 校验，然后用 Edit 工具修改 Markdown；可用 --clean 子命令批量清理审阅产物。审阅 HTML 支持 Shiki 语法高亮（约 235 种语言）、Mermaid、KaTeX 数学公式、GFM 脚注、虚拟分页视图和 WASD 键盘导航。
- 开发者让 Claude Code 生成了规格说明（spec.md），希望在推进前让同事人工画线批注一轮
- 写作者希望对 AI 起草的文档进行多轮「审阅→修改→再审阅」迭代，直到定稿
- 远程/分布式团队中，审阅人只需打开浏览器在单文件 HTML 中批注，无需安装任何东西
- 代理工程师希望以结构化 JSON（而非截图或自由文本）接收人工反馈，便于程序化应用
- 技术写手在 Safari/Firefox 上审阅时，可用 Export as JSON 下载或 Copy as JSON 剪贴板方式回传反馈
这个 Skill 有哪些优点和局限？
- 完全本地、隐私友好：standalone/CLI 构建不外发正文或批注，在线版仅允许列表内的 raw fetch
- 反馈是结构化 JSON，含 headingPath、sourceLine、quote，代理可精确定位应用
- docHash（SHA-256 前 16 位十六进制）让审阅 HTML 与 feedback 文件按轮次机械配对、互不混淆
- 轮询用 run_in_background，Claude 的主回合在审阅期间可并行处理其他任务
- 渲染能力强：Shiki 高亮、Mermaid、KaTeX、脚注、虚拟分页、WASD 键盘导航、手机端支持
- Write feedback. 依赖 File System Access API，Safari/Firefox 用户必须改用导出下载或剪贴板流程
- 若 Claude 在审阅期间自行编辑了 Markdown，sourceLine 会漂移，需退回 quote grep 兜底（技能已内置但仍增加脆弱性）
- 轮询默认 30 分钟超时，长审阅需人工确认延长
- headless/SSH 环境需 --no-open 或依赖端口转发的 HTTP 服务器模式（默认端口 51729），devcontainer 配置不当可能无法访问
- 未在源材料中看到测试套件或基准数据；MDXG 规范本身仍是预览版，Images 渲染仅为 Partial 合规
如何安装这个 Skill？
在项目目录执行：gh skill install oubakiou/mdxg-redline md-review --agent claude-code --scope project，或 npx skills add oubakiou/mdxg-redline --skill md-review --agent claude-code --yes。技能位于仓库的 skills/md-review/SKILL.md。CLI 本体通过 npx mdxg-redline 使用（需 Node.js）。也可从 GitHub Releases 下载 standalone.html 离线审阅。建议在 .claude/settings.local. 的 permissions.allow 中添加源文档给出的三条 Bash 前缀规则。
如何使用这个 Skill？
对 Claude 说「把 docs/spec.md 发出去审阅」或运行斜杠命令 /md-review path/to/markdown.md。流程：技能调用 request-review.sh 生成审阅 HTML 并捕获 stdout 中的 REVIEW_HTML / FEEDBACK_JSON 路径 → 审阅人在浏览器中批注 → wait-feedback.sh 后台轮询（可设超时，默认 1800 秒）→ Claude 读取 feedback. 并把批注应用到 Markdown → 询问「下一轮 / 清理 / 就此结束」。注意：Write feedback. 仅 Chromium 系浏览器支持；脚本必须以 bash + 项目根相对路径调用（gh skill install 会剥掉执行位，且权限规则按前缀匹配）。
这个 Skill 与同类方案有什么区别？
源材料明确指出它是 vercel-labs/mdxg 的第三方实现，遵循 MDXG 规范但与 Vercel Labs 无隶属关系，在其只读 Viewer 能力之上叠加了行内批注与结构化反馈导出。