ink.skill项目解析：用SKILL.md统一AI写作提示词，实现跨平台创作

简介ink.skill 是一套专为长篇连载小说创作设计的跨平台 AI 写作技能体系面向网文作者、轻小说创作者及 AI 辅助写作实践者解决从立项规划、世界观构建、人物设定到逐章生成、自检返修的全流程协同难题。资源包共 65 个文件以 52 份 Markdown 技能文档为核心含 SKILL.md 主入口、12 个题材模板如 xuanhuan.md/isekai.md、10 余项专项能力模块如 write.md/revise.md/post-write-validator.md辅以 4 个结构化模板、3 个 Python 工具脚本用于真值合并、章节校验与骨架初始化及标准化治理文件LICENSE、.gitignore 等整体仅 194KB轻量高效。已有 214 人学习下载。用户可直接部署该 skill 框架获得三层记忆维护机制、定向修订指令集、敏感词与写作禁忌管控、章节级真值校验逻辑以及覆盖玄幻、系统流、都市异能等 12 类主流网文题材的开篇引导与设定规范。1. 项目概述一份文件撬动AI写作的无限可能最近在折腾AI辅助写作特别是小说创作这块发现一个挺头疼的事儿不同的AI模型比如Claude、ChatGPT甚至是一些本地部署的大模型它们的“技能”或者说“提示词工程”格式五花八门。今天在Claude上调试好了一套完美的小说设定、角色生成和情节推进流程想迁移到另一个平台或者分享给朋友用得又得重新整理、适配费时费力。这就像给每个不同的厨房都准备一套完全不同的菜谱效率太低了。直到我遇到了ink.skill这个项目。它的核心思路极其巧妙甚至可以说有点“叛逆”它不试图去统一所有AI而是定义了一份名为SKILL.md的通用技能描述文件。你可以把这份文件看作是写给AI看的“标准化工作说明书”。通过一个配套的解析工具这份SKILL.md文件可以自动转换成适配 Claude、Cursor基于Code模式等多种AI写作环境的专用格式甚至能打包成可直接分发的技能包Code.zip。这意味着作为创作者你只需要维护一份核心的“技能源码”就能在多个平台上获得一致的、高质量的AI写作辅助体验。这不仅仅是跨平台更是一种创作工作流的标准化和资产化对于严肃对待AI写作的创作者来说价值巨大。2. 核心设计思路为什么是 SKILL.md在深入细节之前我们得先弄明白为什么ink.skill选择SKILL.md作为核心载体而不是JSON、YAML或者其他配置文件。这背后其实是对“人机协同”工作流的深刻理解。2.1 以文档为中心而非以配置为中心大多数工具喜欢用结构化的配置文件JSON/YAML因为它们机器友好易于解析。但ink.skill反其道而行之采用 Markdown 文件。原因有三第一可读性与可维护性。SKILL.md 首先是给人看的。一份优秀的小说写作技能包含了角色设定、世界观规则、文风要求、情节模板等大量自然语言描述。把这些内容硬塞进JSON的键值对里会变得支离破碎难以阅读和修改。而Markdown完美地融合了结构化标题、列表、代码块和自由文本创作者可以在一个文件里流畅地撰写所有内容就像在写项目文档一样自然。第二便于版本控制与协作。.md 文件是纯文本与 Git 等版本控制系统是天作之合。你可以清晰地看到每次对技能描述的修改diff方便团队协作和迭代历史回溯。试想一下和伙伴一起打磨一个“科幻赛博朋克”的写作技能通过Git来管理SKILL.md的变更体验会非常顺畅。第三降低使用门槛。对于创作者而言学习一种新的配置文件语法是额外的负担。而Markdown几乎是数字时代的通用语任何人稍加了解就能上手编辑SKILL.md这极大地扩展了工具的潜在用户群。2.2 抽象层与转换器的价值ink.skill的核心架构是一个“抽象层”加多个“转换器”。SKILL.md 就是这个抽象层它定义了一套与具体AI平台无关的技能描述标准。而项目的转换器或编译器则负责将这份标准描述“翻译”成目标平台能理解的格式。例如Claude 的 Code 模式可能期望技能以特定的注释格式内嵌在代码文件中而另一个工具可能期望一个包含多个提示词片段的文件夹结构。ink.skill的转换器会解析 SKILL.md 中的章节如## 角色设定、## 文风要求提取关键信息然后按照目标平台的规则重新组装。这样创作者就从繁琐的平台适配工作中解放出来只需关注技能内容本身的质量。注意这种设计意味着 SKILL.md 需要遵循一定的内部结构约定虽然它是Markdown但并非完全自由格式。后续的实操部分会详细说明其必备的章节和语法。3. SKILL.md 文件结构深度解析一份能有效工作的 SKILL.md其结构是经过精心设计的。它不仅仅是一篇文档更是一个可执行的“程序”。下面我们来拆解它的标准构成部分。3.1 元信息区技能的“身份证”文件开头通常是一个 YAML Front Matter 区块用三条横线包裹。这里定义了技能的基本元数据这些信息对于工具识别、分类和打包至关重要。--- name: “悬疑惊悚小说创作助手” version: 1.2.0 author: 你的名字 description: 专注于生成氛围紧张、逻辑缜密的悬疑惊悚故事。擅长铺设伏笔和制造反转。 platforms: [claude-code, cursor] tags: [小说 悬疑 惊悚 创作] ---name description: 清晰明了让使用者一眼就知道这个技能能干什么。version: 强烈建议使用语义化版本号如主版本.次版本.修订号便于技能更新和管理。platforms: 声明此技能设计时考虑支持的目标平台。转换器可能会根据这个列表来生成对应的输出。tags: 关键词标签方便后续在技能库中搜索和筛选。3.2 核心技能定义区从世界观到对话模板这是文件的主体用各级 Markdown 标题来组织。以下是一个高度概括的结构每个部分都可以无限细化。## 1. 角色与视角 ### 1.1 叙事视角 明确要求AI采用第几人称如第一人称受限视角增强代入感第三人称全知视角便于铺陈。 ### 1.2 作者角色定义 将AI定位为“资深故事编辑”、“合作创作者”或“灵感激发器”这会影响它回应的口吻和主动性。 ## 2. 世界观与设定框架 ### 2.1 核心概念 用一段话精炼概括故事发生的独特世界如“一个记忆可以像货币一样交易的黑市社会”。 ### 2.2 基础规则 列出这个世界必须遵守的物理、魔法或社会规则如“魔法消耗施法者的情感能量”。 ## 3. 角色生成规范 ### 3.1 角色属性表 设计一个表格模板要求AI在生成新角色时填充。 | 属性 | 说明 | 示例 | | :--- | :--- | :--- | | 姓名 | | | | 核心欲望 | 驱动角色的根本动力 | | | 致命缺陷 | 角色最大的弱点 | | | 标志性细节 | 一个让人物立住的独特习惯或外貌特征 | | ### 3.2 角色关系网 指导AI如何构建角色间的复杂关系如利用“关系三角”制造戏剧冲突。 ## 4. 情节与结构引擎 ### 4.1 节拍表模板 引入电影编剧中的“节拍表”概念提供一套结构模板如开场画面 - 触发事件 - 争论 - 第二幕衔接点...要求AI在构思大纲时参照。 ### 4.2 冲突类型库 定义本类小说常用的冲突类型如人 vs. 超自然 人 vs. 科技 内心道德困境供AI在推进情节时调用。 ## 5. 文风与语言指导 ### 5.1 词汇表与禁忌词 - **推荐词汇**氤氲、窥伺、心悸、悄无声息... - **禁忌词汇**避免使用“突然”、“没想到”等直白表述改用更具画面感的描写。 ### 5.2 句子节奏范例 提供例句展示期望的句子长短节奏和修辞手法如短句制造紧张长句进行环境铺陈。 ## 6. 交互协议与工作流 这是最关键的部分定义了用户如何与搭载此技能的AI进行一步步的协作。 ### 6.1 初始化流程 用户输入“/start”或类似指令后AI应如何响应如输出欢迎语并引导用户选择“生成新故事”或“继续现有故事”。 ### 6.2 核心指令集 定义一套清晰的命令就像软件的快捷键。/character -- 根据当前情境生成一个符合设定的新角色。 /plot [方向] -- 基于当前故事线生成三个可能的情节发展方向。 /revise -- 对上一段AI生成的内容进行自我批判和修改使其更符合设定。### 6.3 上下文管理规则 明确告诉AI如何记忆和利用历史对话。例如“始终记住故事中已出现角色的姓名和关键特征。当用户提及‘他’时结合上下文明确指代对象。”实操心得在编写SKILL.md时示例的力量远大于抽象要求。在“文风指导”部分不要只说“文笔要细腻”而是直接给出两段对比文字一段是你认为不合格的一段是你期望的。AI从具体示例中学习的效果好得多。4. 从 SKILL.md 到多平台部署转换与打包实战有了精心编写的 SKILL.md下一步就是让它能在不同的AI平台上跑起来。ink.skill项目提供的工具链通常是命令行工具或脚本就是这个过程的“编译器”。4.1 转换流程详解假设我们有一个写好的mystery_novel.skill.md文件。转换过程一般如下安装与配置首先需要安装ink.skill的核心工具。这可能是一个Python包通过pip install ink-skill安装或者是一个下载的独立可执行文件。平台适配转换使用命令行工具指定目标平台进行转换。# 转换为 Claude Code 模式可用的格式 ink-skill compile mystery_novel.skill.md --platform claude-code --output ./claude_skill # 转换为 Cursor 智能感知可用的格式 ink-skill compile mystery_novel.skill.md --platform cursor --output ./cursor_skill执行上述命令后工具会解析skill.md并根据--platform指定的适配器生成一个结构化的文件夹。例如对于claude-code可能会生成一个包含特定注释格式的.py或.js文件对于cursor可能会生成一个包含system_prompt.md和多个snippet文件的文件夹。人工微调可选但推荐转换器不可能100%完美适配所有场景。生成后你应该检查一下输出文件。特别是对于 Claude Code你需要将生成的代码块或提示词手动复制到 Claude 的代码解释器Code Interpreter会话中或者保存为项目文件。检查关键指令是否被正确放置上下文长度是否合适。4.2 打包与分发Code.zip 的奥秘ink.skill另一个亮点是支持打包成Code.zip。这个功能对于分享和部署至关重要。当你运行打包命令时ink-skill pack mystery_novel.skill.md --output mystery_novel_code.zip工具会做以下几件事将 SKILL.md 本身包含进去。根据 SKILL.md 中声明的platforms自动为每个平台执行转换并将转换后的结果放入 zip 包内对应的子文件夹如/claude-code/,/cursor/。可能还会包含一个README.txt简要说明如何使用每个平台下的技能文件。这样你分享给别人的就是一个“开箱即用”的技能包。接收者只需要解压找到对应平台的文件夹按照里面的说明操作即可无需自己运行转换命令。这极大地降低了协作和传播的门槛。避坑指南在打包前务必在本地用转换命令为每个平台测试一遍生成结果。有时因为 SKILL.md 中使用了某个平台不支持的语法或结构转换会失败或产生错误输出。确保每个平台的输出都可用后再打包避免分享出去一个“残次品”。5. 高级技巧打造可进化的“活”技能一个静态的技能文件迟早会过时。优秀的 SKILL.md 应该设计成可以学习和进化的。以下是一些进阶思路。5.1 技能参数化与动态注入不要让所有设定都写死。可以在 SKILL.md 中设计“变量”或“占位符”。例如在“世界观”部分可以这样写## 世界观 故事发生在一个 {city_type} 城市。这里的主要能源是 {energy_source}。然后你可以创建一个配套的、简单的配置文件如config.json或通过交互命令来注入这些变量{ “city_type”: “衰败的工业港口” “energy_source”: “从古老生物化石中提取的‘灵尘’” }转换器或在运行时可以将这些变量值替换到最终的提示词中。这样一个基础的“都市奇幻”技能就能通过注入不同的参数快速衍生出“蒸汽朋克伦敦”或“赛博朋克东京”等多种变体。5.2 集成外部知识库对于需要大量专业知识的写作如历史小说、硬科幻可以让技能引用外部知识库。在 SKILL.md 中不要试图把所有历史细节或科学原理都写进去而是指导AI如何查询和运用这些知识。例如## 资料引用规范 当涉及军事装备描写时请参考项目根目录下 /knowledge_base/weapons.md 文件中的术语和数据。 当构建天文场景时可调用 /knowledge_base/astrophysics_glossary.md 中的概念。你需要将对应的知识库 Markdown 文件和 SKILL.md 一起管理和打包。AI在生成内容时虽然不能直接“读取”这些文件但你可以通过指令让它“回忆”或“应用”知识库中定义的概念或者在生成文本后由你根据知识库进行人工校验和修正。这是一种“人机核对”的工作流。5.3 创建技能组合与流水线复杂的创作可能需要多个技能协作。例如你可以有一个“世界观构建.skill.md”一个“角色深度塑造.skill.md”还有一个“对话生成.skill.md”。你可以设计一个“主”技能在 SKILL.md 的交互协议中定义如下流程用户输入故事种子。调用【世界观构建】技能生成基础设定。调用【角色塑造】技能基于世界观生成主要角色。调用【情节大纲】技能生成故事框架。进入主写作环节此时切换或融合【对话生成】和【描写润色】技能。目前这可能需要你在不同AI会话间手动切换技能文件或者依赖更高级的AI Agent框架来编排。但ink.skill这种标准化格式为未来实现自动化的技能流水线编排奠定了坚实的基础。6. 常见问题与实战排坑记录在实际使用和与他人交流的过程中我总结了一些典型问题和解决方案。6.1 转换后指令在AI中效果不佳问题在SKILL.md里写得好好的指令转换到Claude里之后AI似乎“看不懂”或执行不到位。排查思路检查上下文位置在Claude Code中系统提示System Prompt和用户提示User Prompt的位置和权重不同。确保你的核心约束如文风、禁忌词被放在了正确的、影响力大的位置通常是系统提示或对话开头。指令过于复杂AI对长串的、嵌套的指令理解会衰减。尝试将复杂的指令拆分成多个简单、清晰的步骤并在交互协议中分步引导用户触发。缺乏示例这是最常见的问题。光说“生成一个复杂的反派”没用。在SKILL.md中必须附带一个甚至多个完整的、高质量的示例展示一个符合你要求的反派角色描述是什么样子。AI是模式匹配的大师示例是最有效的教导。6.2 技能文件臃肿导致AI上下文溢出问题SKILL.md写得非常详细加上示例后内容极长转换后超出了AI模型的上下文窗口限制。解决方案分层设计将技能分为“核心版”和“完整版”。核心版只包含最关键的指令和1-2个示例用于日常快速写作。完整版包含所有知识库和丰富示例仅在需要深度定制或AI“遗忘”时作为参考文档查阅。外部化示例将大量的示例场景、对话样本移出主SKILL.md文件单独存放。在SKILL.md中通过引用说明如“参见examples/plot_twist_cases.md”在实际使用时根据需要手动复制1-2个最相关的示例到对话中。利用AI的总结能力在技能中设计一条指令如/summarizeContext让AI主动总结当前会话中已确立的核心设定从而释放上下文空间。6.3 跨平台兼容性细节差异问题在Platform A上运行完美的技能转换到Platform B后有些功能失效。根因不同平台对提示词的解析、对系统角色的设定、对长文本的处理方式存在细微差异。应对策略为每个平台创建适配章节可以在SKILL.md中使用条件注释或平台标识。!-- PLATFORM: claude-code -- 对于Claude请特别注意将角色设定放在系统提示的开头部分。 !-- END PLATFORM -- !-- PLATFORM: cursor -- 对于Cursor可以利用其代码补全特性将角色属性表设计为代码片段。 !-- END PLATFORM --转换器在转换时会只保留当前目标平台相关的注释块内容。这需要ink.skill工具链支持此类预处理功能或者你手动维护不同平台的微调版本。建立平台专属的“测试用例”为你的技能设计几个标准测试场景如“生成一个开头”、“修改一段对话”。在每次为新技术台转换技能后运行这些测试对比输出结果快速定位平台差异所在并回头调整SKILL.md中的对应描述。6.4 技能迭代与版本管理问题技能在使用中不断优化如何有效管理这些变更最佳实践严格使用Git将SKILL.md文件置于Git仓库中。每次有大的优化或调整都进行一次提交并编写清晰的提交信息如“v1.1增加了对话节奏的示例”、“v1.2修复了在Claude上角色记忆丢失的问题”。维护更新日志在SKILL.md文件末尾或单独的CHANGELOG.md中记录每个版本的变化。这对于团队协作和日后回溯至关重要。语义化版本号如前所述在元信息中使用major.minor.patch。当你只是增加示例或修改措辞向后兼容增加修订号当你新增了功能章节增加次版本号当你对技能结构或核心指令做了不兼容的改动增加主版本号。7. 个人实践从零构建一个“中式奇幻志怪”写作技能理论说了这么多我来分享一下我实际构建一个技能的过程。我的目标是创建一个用于创作“中式奇幻志怪”短篇小说的AI技能。第一步定义核心与边界我首先问自己什么是“中式志怪”的核心是《聊斋》式的人妖情未了还是《山海经》式的奇珍异兽我决定聚焦于“现代都市背景下的轻微怪谈”核心氛围是“日常中的诡异”避免宏大的仙侠战斗。这个定位直接影响后续所有设定。第二步搭建SKILL.md骨架我按照前面的结构先创建了元信息和主要章节标题。在“世界观”部分我写道“故事发生在看似正常的当代中国都市但存在一些未被广泛认知的‘缝隙’如午夜后的特定小巷、老式收音机的某个频段怪异在其中悄然滋生。”这一定位非常关键。第三步填充血肉重在示例角色我设计了一个角色属性表强调“现代职业”与“隐秘渊源”的结合如程序员但家族世代是“网络风水师”。文风我找了作家阿乙的一段描写作为正面示例强调冷峻、克制的白描手法。同时我写了一段“反面教材”过度使用感叹词和夸张比喻让AI明白要避免什么。情节我提供了三个完整的情节“种子”示例每个都包含1. 一个日常物品的异变如会自己移动的旗袍2. 主角调查的初步发现3. 一个细思极恐的转折暗示。第四步交互协议设计我设计了/weird [日常物品]指令让AI基于一个普通物品生成怪谈设定。还设计了/clue指令当故事陷入平淡时让AI给出一个隐藏线索的建议。最重要的指令是/tone_check让AI自我评估最近一段描写是否偏离了“克制诡异”的文风并给出修改建议。第五步转换、测试与迭代我将写好的zhiguai.skill.md转换为 Claude Code 格式。第一次测试AI生成的怪谈过于“美式恐怖”血腥直接。我意识到问题在于“反面示例”不够具体。我回头增加了对比强调“恐怖源于未知和留白而非直观的血腥描述”。第二次测试效果显著提升。第六步打包分享经过几轮测试和微调后我使用ink-skill pack命令将其打包成zhiguai_code.zip分享给了几个同样写小说的朋友。他们解压后在各自的Claude或Cursor中加载我们就能在同一个“创作宇宙”的规则下讨论和续写彼此的故事开头体验非常奇妙。这个过程让我深刻体会到ink.skill不仅仅是一个格式转换工具它更是一个迫使你进行结构化思考的创作框架。当你把模糊的写作想法变成一份条理清晰的 SKILL.md 时你对自己想写什么、要怎么写已经清晰了一大半。剩下的就是和AI这位不知疲倦的协作者一起将蓝图变为精彩的文字了。本文还有配套的精品资源点击获取