1实现原理 · 为什么它能做到
职责二分：内容层面的分析/重构由模型按 SKILL.md 的步骤做（Step 1-5），排版层面的确定性修复交给自带脚本（Step 6）。
skills/baoyu-format-markdown/SKILL.md
Claude performs content analysis and formatting (Steps 1-5), then runs the script for typography fixes (Step 6).
注：这里在做什么：把『不可验证的编辑判断』与『可脚本化的排版修复』分开，脚本不参与内容改写，因此模型越权的空间被步骤划分限制。
核心纪律是『只调格式、不碰内容』：不改写、不增删、不加评论性内容。
skills/baoyu-format-markdown/SKILL.md
**Core principle**: Only adjust formatting and fix obvious typos. Never add, delete, or rewrite content.
注：Step 4 把它展开为禁止清单（Do NOT add sentences/explanations、Do NOT rephrase…）与允许清单（保留作者语气、用加粗标出结论、把并列项提炼为列表/表格）。
脚本主体是 unified/remark 管线：解析 → 可选 CJK 友好强调修复 → GFM/frontmatter → stringify，然后原地写回文件。
skills/baoyu-format-markdown/scripts/main.ts
.use(options.emphasis ? remarkCjkFriendly : [])
注：frontmatter 由 YAML.parseDocument 重排（`doc.toString({ lineWidth: 0 })`），文本节点里若有引号需求则替换为全角引号；最终 `writeFileSync(filePath, formattedContent, "utf-8")` 覆盖原文件。
CJK/英文间距不是自己实现，而是运行时调用 npx autocorrect-node --fix 就地改文件。
skills/baoyu-format-markdown/scripts/autocorrect.ts
const result = spawnSync(npxCmd, ["autocorrect-node", "--fix", filePath], {
注：spacing 默认 true，因此默认路径会从 npm registry 拉取 autocorrect-node；可用 --no-spacing 关闭。
可选的引号规范化：把成对 ASCII 双引号与「」替换为全角弯引号。
skills/baoyu-format-markdown/scripts/quotes.ts
.replace(/"([^"]+)"/g, "\u201c$1\u201d")
注：默认关闭（DEFAULT_OPTIONS.quotes=false），仅当传 --quotes 时对文本节点生效。
标题生成走可复用公式库：references/title-formulas.md 提供 8 个 hook 公式 + 直白型，输出 4-5 个候选交给用户选。
skills/baoyu-format-markdown/references/title-formulas.md
8 hook formulas + straightforward style for balanced title generation.
注：SKILL.md 要求：先抽核心论点/最强观点/读者痛点，选中 2-3 个最匹配公式生成 hook 标题、再补 1-2 个直白标题（`using formulas from `references/title-formulas.md``），最强 hook 放第一并标 (recommended)。
frontmatter 字段有固定加工规则：title/slug/summary/description/coverImage，summary 与 description 双版本且长度有指标。
skills/baoyu-format-markdown/SKILL.md
| `summary` | 1 sentence, ~50-80 chars | Concise hook — for feeds, social sharing, SEO meta |
注：同日禁止模式（禁用『This article introduces…』式开头）；已存在 title 仍会重新生成候选，但已存在的 summary/description 会保留、只补缺失项。
写盘纪律：输出 {filename}-formatted.md，覆盖前先按时间戳备份；分析文档 {original-filename}-analysis.md 作为改稿依据保留。
skills/baoyu-format-markdown/SKILL.md
mv "{filename}-formatted.md" "{filename}-formatted.backup-$(date +%Y%m%d-%H%M%S).md"
注：Markdown 检测到格式时先问用户三选一（优化格式 / 保留原格式 / 仅排版修复），第三项会直接原地改原文件——这是本 skill 唯一直接修改用户源文件的分支。
2核心能力
01Markdown/纯文本分类与三条处理路径（优化/保留原格式/仅排版）
02读者视角内容分析：亮点/金句、结构、行动信息、排版问题四维，落盘为 -analysis.md
03frontmatter 生成与规范化（title/slug/summary/description/coverImage）
04公式驱动的多候选标题生成 + 用户选择（auto_select 可跳过）
05排版修复脚本：CJK/英文间距（autocorrect）、CJK 强调标点、全角引号、frontmatter YAML 重排
06偏好文件 EXTEND.md（项目/XDG/home 三级）控制 auto_select 等行为
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | npx autocorrect-node --fix（CJK/英文间距修复） |
| package | remark-cjk-friendly |
| package | remark-parse / remark-stringify / remark-gfm / remark-frontmatter / unified / unist-util-visit / yaml |
| cli | bun（首选运行时；无 bun 时 npx -y bun） |
4风险提醒 风险提醒：黄色 · 留意使用
风险提醒：黄色 · 留意使用
- 默认路径会原地改写用户源文件 — 用户在检测到已有 Markdown 时若选『Typography fixes only』，脚本直接对原文件 writeFileSync，损坏不可自动回滚（该分支不产生备份）；建议先拷贝再跑。
- 运行时拉取未锁定版本的第三方 CLI — spacing 默认开启，autocorrect.ts 会用 npx 拉取 autocorrect-node 的最新版并执行；上游发版行为变化会直接体现在文件改动上。
- 『不改内容』是提示级约束，非代码强制 — Step 2-4 的改写/加粗/建表全部由模型执行，脚本不校验内容是否被改；是否符合『Only adjust formatting』依赖模型遵守 SKILL.md。
- 标题/摘要质量不可机械验证 — 公式驱动的候选标题仍可能偏离原文主张或不符平台风格，SKILL.md 要求用户选择，如果用户走 auto_select 则完全由模型定夺。
风险提醒：黄色，留意使用。三段自证：① 判级对象是本 skill 目录（SKILL.md + scripts/{main,quotes,autocorrect}.ts + references/title-formulas.md）；② 目录内自身行为＝本地读写（原地改用户 md、写 -formatted.md/-analysis.md/备份），加一次固定公开端点外发：`skills/baoyu-format-markdown/scripts/autocorrect.ts` 的 `spawnSync(npxCmd, ["autocorrect-node", "--fix", filePath] …)` 会在默认 spacing 开启时从 registry.npmjs.org 拉取并执行该第三方 CLI；③ 无凭证/密钥读取、无用户内容出网、无逆向/冒充/绕过/安全降级，故为黄而非橙红。留意点：默认路径会原地修改用户源文件（第三条路径）与跑未锁定版本的 npx 包，已写入 verdict.risks。
5第二遍独立确认
- [ok] 『模型做内容、脚本做排版』的两段式划分 — SKILL.md Workflow 段逐字：'Claude performs content analysis and formatting (Steps 1-5), then runs the script for typography fixes (Step 6).' 与脚本能力一致（脚本无内容改写逻辑）。
- [ok] 脚本的确定性修复项与默认值 — main.ts DEFAULT_OPTIONS={quotes:false, spacing:true, emphasis:true}；--quotes/--no-spacing/--no-emphasis 均有对应分支；与 SKILL.md 选项表一致。
- [ok] npx autocorrect-node 为唯一外部命令调用 — 全目录 grep spawn/exec/npx 仅 autocorrect.ts 命中一处；main.ts 只有 readFileSync/writeFileSync。
- [ok] 外部依赖清单完整性 — package.json 声明 8 个包（remark 生态 + unified + yaml），另加运行时 npx 的 autocorrect-node；全目录无任何 http 端点/API 调用。
- [ok] 无凭证读取 — 目录内 token 扫描 API_KEY/TOKEN/SECRET/.env/keychain 零命中；仅读取 EXTEND.md 偏好（路径在 SKILL.md 明列）。
- [ok] 标题公式库内容与『8 个公式』一致 — references/title-formulas.md 首行 '8 hook formulas + straightforward style for balanced title generation.'，表格确为 8 行 hook（Subversive…Empathy）。
- [ok] 『仅排版修复』会原地改用户文件 — SKILL.md 第三条路径写明 'Run typography script on original file in-place / No copy created, modifies original file directly'，与 main.ts writeFileSync(filePath…) 行为一致，已列为使用注意。
- [ok] 元数据（license/stars/commit） — git HEAD=1567581c26ec29f4216c6e6835415bf30343b0e3；仓库根 LICENSE=MIT（Copyright (c) 2026 Jim Liu）；GitHub API stars=25926、pushed_at=2026-09-10T15:13:43Z。
6结论
适合：适合把自己写的长文/访谈稿/公众号草稿交给 agent 做一遍『结构可扫读、重点可抓取』的排版重整，并顺手生成 frontmatter（title/slug/summary/description）的场景；也适合作为 markdown-to-html、post-to-wechat 等下游 skill 的前置清洗步骤（默认 spacing/emphasis 修复能避免微信端加粗解析失败）。
不适合：不适合需要严格版式一致性（应使用固定模板/CI 校验）或不允许任何原文改动的合规文书；不适合把已有 Markdown 原文当唯一副本、且不接受原地改写的场景（第三条路径会直接覆盖）；也不适合期望脚本自身做内容改写/翻译的需求——本 skill 明确只调格式不碰内容。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 baoyu-format-markdown.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent6367312d8f2334bb…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库JimLiu / JimLiu/baoyu-skills
原始 GitHubJimLiu/baoyu-skills ↗
Stars25926
最近推送2026-09-10
本 skill commit
1567581c26许可MIT（仓库根 LICENSE，Copyright (c) 2026 Jim Liu；GitHub API spdx_id=MIT）
本站信息
收录日期2026-09-06
分类文档与知识
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。