尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

如何保留作者的精确命名:book-to-skill的patterns.md写作规范详解

如何保留作者的精确命名:book-to-skill的patterns.md写作规范详解 如何保留作者的精确命名book-to-skill的patterns.md写作规范详解【免费下载链接】book-to-skillTurn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.项目地址: https://gitcode.com/GitHub_Trending/bo/book-to-skillbook-to-skill可以把任意技术书 PDF 变成 AI 可直接调用的技能skill而其中的patterns.md是全书技巧与设计模式的工具箱。这篇文章详解 patterns.md 的写作规范教你保留作者的精确命名——为什么The 5 Whys不能写成多问几次为什么以及当合并新内容时如何让命名风格保持一致。book-to-skill 书籍转技能转换器横幅展示书本知识转化为 AI 技能结构 图注本书把书籍结构编译为按需加载的 skill 文件patterns.md 是其中技术模式层。为什么强调精确命名结构大于摘要book-to-skill 的核心理念是提取结构而非生成摘要Extract structure, not summaries。作者为每个框架取名都有原因名字本身就是知识的一部分The 5 Whys ≠ ask why multiple times—— 改名即丢失了方法论的辨识度质量规则第 2 条明确要求Preserve the authors precision保留作者的精确性保留原始命名与表述质量规则第 4 条要求从业者口吻写 Use X when Y当 Y 时用 X而不是 The book explains X本书介绍了 X。这套规则写在生成规范 SKILL.md 的 Quality Rules 一节约第 754 行是转换全程的底线约束。patterns.md 是什么技巧与模式的集中索引运行 book-to-skill 后会在你的技能目录如~/.claude/skills/skill_name/生成一组文件patterns.md 是其中之一文件职责典型体量SKILL.md核心心智模型 章节/主题索引~4,000 tokenschapters/*.md每章摘要按需加载~1,000 tokens/章glossary.md术语表按字母序排列~1,500 tokenspatterns.md所有技巧、算法与设计模式~2,000 tokenscheatsheet.md决策表与速查规则~1,200 tokens分工口诀术语归 glossary决策规则归 cheatsheet可复用的招式归 patterns.md。它的定位是推理辅助工具而不是关键词列表——任何人都能 grep 术语patterns.md 沉淀的是作者判断力的载体。写作规范三段式结构 原名直用patterns.md 中每个模式的标准格式见 SKILL.md Step 8约第 468 行## 模式名保留作者原名的英文/原文标题 **When to use**: 什么场景下使用 **How**: 具体步骤或判据 **Trade-offs**: 代价与局限配合章节文件chapters/chNN-slug.md中的 Frameworks Introduced 小节命名规则更直接框架名必须是原书名exact formulation — preserve the authors naming精确表述保留作者命名名称之后紧跟何时用 / 怎么做两行不展开长段全书总长控制在2,000 tokens以内——宁缺毋滥密度优先于完整Density over completeness。自检清单4 个问题验证命名是否精确写完一个模式后用这 4 个问题过一遍 这个名字能在原书中被直接搜索到吗搜不到 你改了名 How 里的步骤是作者的原始步骤还是你的转述⚖️ Trade-offs 是作者明示的代价还是你自己脑补的‍ 作者本人看到这条记录会认这是他的框架吗若任何一条存疑回到对应章节原文核对——patterns.md 的价值恰恰在于可追溯到原书。book-to-skill 项目分享卡片书籍知识结构化输出为技能文件合并更新时如何保持命名风格一致当后续用Update / Fold-in模式把新内容并入已有技能时SKILL.md 的 Update Workflow约第 731 行patterns.md 的合并规则是先读取现有$SKILLS_HOME/skill_name/patterns.md从新内容中提取新增的技巧、算法、模式追加新条目保持与既有条目完全一致的三段式格式与命名风格合并后总长控制在2,500 tokens以内。也就是说精确命名不仅是一次性要求而是在每次增量合并中持续校验的不变量。常见疑问patterns.md 会撑爆上下文吗不会。章节与辅助文件都是按需加载的patterns.md 只有在被明确读取时才计入 token 成本。因此写作时不必为省 token 而压缩表述——优先保证命名与表述的精确度用 2,000 tokens 写干货而不是用 10,000 tokens 堆摘录。相关资料SKILL.md — 完整生成规范Steps 0–10 合并流程 Quality RulesREADME.md — 生成文件清单与用途速览docs/how-it-works.md — 从提取到生成的全流程图解docs/architecture.md — 架构、设计原则与关键模块docs/usage.md — 四种使用模式与示例scripts/extract.py — 文本提取入口脚本输出文章等等我需要修正图片路径——必须使用仓库中真实存在的图片文件路径。输出文章如何保留作者的精确命名book-to-skill的patterns.md写作规范详解book-to-skill可以把任意技术书 PDF 变成 AI 可直接调用的技能skill而其中的patterns.md是全书技巧与设计模式的工具箱。这篇文章详解 patterns.md 的写作规范教你保留作者的精确命名——为什么The 5 Whys不能写成多问几次为什么以及合并新内容时如何让命名风格保持一致。为什么强调精确命名结构大于摘要book-to-skill 的核心理念是提取结构而非生成摘要Extract structure, not summaries。作者为每个框架取名都有原因名字本身就是知识的一部分The 5 Whys ≠ ask why multiple times—— 改名即丢失了方法论的辨识度质量规则第 2 条明确要求Preserve the authors precision保留作者的精确性保留原始命名与表述质量规则第 4 条要求从业者口吻写 Use X when Y当 Y 时用 X而不是 The book explains X本书介绍了 X。这套规则写在生成规范 SKILL.md 的 Quality Rules 一节约第 754 行是转换全程的底线约束。patterns.md 是什么技巧与模式的集中索引运行 book-to-skill 后会在你的技能目录如~/.claude/skills/skill_name/生成一组文件patterns.md 是其中之一文件职责典型体量SKILL.md核心心智模型 章节/主题索引~4,000 tokenschapters/*.md每章摘要按需加载~1,000 tokens/章glossary.md术语表按字母序排列~1,500 tokenspatterns.md所有技巧、算法与设计模式~2,000 tokenscheatsheet.md决策表与速查规则~1,200 tokens分工口诀术语归 glossary决策规则归 cheatsheet可复用的招式归 patterns.md。它的定位是推理辅助工具而不是关键词列表——任何人都能 grep 术语patterns.md 沉淀的是作者判断力的载体。写作规范三段式结构 原名直用patterns.md 中每个模式的标准格式见 SKILL.md Step 8约第 468 行## 模式名保留作者原名的标题 **When to use**: 什么场景下使用 **How**: 具体步骤或判据 **Trade-offs**: 代价与局限配合章节文件chapters/chNN-slug.md中的 Frameworks Introduced 小节命名规则更直接框架名必须是原文原名exact formulation — preserve the authors naming精确表述保留作者命名名称之后紧跟何时用 / 怎么做两行不展开长段全书总长控制在2,000 tokens以内——宁缺毋滥密度优先于完整Density over completeness。自检清单4 个问题验证命名是否精确写完一个模式后用这 4 个问题过一遍 这个名字能在原书中被直接搜索到吗搜不到 你改了名 How 里的步骤是作者的原始步骤还是你的转述⚖️ Trade-offs 是作者明示的代价还是你自己脑补的‍ 作者本人看到这条记录会认这是他的框架吗若任何一条存疑回到对应章节原文核对——patterns.md 的价值恰恰在于可追溯到原书。合并更新时如何保持命名风格一致当后续用Update / Fold-in模式把新内容并入已有技能时SKILL.md 的 Update Workflow约第 731 行patterns.md 的合并规则是先读取现有$SKILLS_HOME/skill_name/patterns.md从新内容中提取新增的技巧、算法、模式追加新条目保持与既有条目完全一致的三段式格式与命名风格合并后总长控制在2,500 tokens以内。也就是说精确命名不仅是一次性要求而是在每次增量合并中持续校验的不变量。常见疑问patterns.md 会撑爆上下文吗不会。章节与辅助文件都是按需加载的patterns.md 只有在被明确读取时才计入 token 成本。因此写作时不必为省 token 而压缩表述——优先保证命名与表述的精确度用 2,000 tokens 写干货而不是用 10,000 tokens 堆摘录。相关资料SKILL.md — 完整生成规范Steps 0–10 合并流程 Quality RulesREADME.md — 生成文件清单与用途速览docs/how-it-works.md — 从提取到生成的全流程图解docs/architecture.md — 架构、设计原则与关键模块docs/usage.md — 四种使用模式与示例scripts/extract.py — 文本提取入口脚本【免费下载链接】book-to-skillTurn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.项目地址: https://gitcode.com/GitHub_Trending/bo/book-to-skill创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表