FeelFish LogoFeelFish
docs

技能构建完全指南

2026-03-11•FeelFish Team

FeelFish 小说创作技能构建完全指南

目录

引言

技能（Skill） 是一组写作规范与流程指令——打包成一个简单的文件夹——用于教导 FeelFish 的智能体如何处理特定的创作任务或写作工作流。技能是为满足你的创作需求定制 AI 的最强大方式之一。无需在每次对话中重新解释你的人物设定、写作风格和叙事逻辑，技能让你一次性教导智能体，每次创作都能稳定受益。

当你拥有可重复的创作工作流时，技能会变得极为强大：比如按世界观设定生成章节草稿、按固定节奏推进情节、创建符合角色性格的对话，或编排大纲拆解→章节扩写→润色去 AI 味的多步骤流程。它们与 FeelFish 的内置功能（智能体协作、知识库、智能上下文）配合得天衣无缝。

本指南涵盖了构建有效小说创作技能所需了解的一切——从规划和结构到测试和分发。无论你是为自己、团队还是社区构建技能，都能在整个过程中找到实用的模式和真实的写作场景示例。

你将学到

  • 技能结构的技术要求和最佳实践
  • 独立技能与多智能体协作工作流的常见模式
  • 我们在不同小说类型中观察到的有效做法
  • 如何测试、迭代和分发你的技能

适用对象

  • 希望 FeelFish 始终遵循自己写作风格与流程的独立作者
  • 希望在全书创作过程中保持设定一致性的长篇小说创作者
  • 希望在团队或平台内标准化 AI 辅助写作方式的网文工作室

本指南的两条路径

构建独立创作技能？ 请重点关注「基础」和「规划与设计」章节——技能无需绑定多智能体即可独立发挥作用。

构建多智能体协作方案？ 「模式」章节中的多智能体编排模式适合你。两条路径共享相同的技术要求，按需选取与你工作流相关的内容即可。

预期投入： 到最后，你将能够构建一个功能完整的小说创作技能。预计首次构建并测试完成大约需要 15–30 分钟。

让我们开始吧。

第 1 章：基础

什么是技能？

在 FeelFish 中，技能是一个包含以下内容的文件夹，存放于项目的 .feelfish/skills/<技能名>/ 路径下：

文件/目录是否必需用途
SKILL.md必需包含 YAML 前置元数据的 Markdown 指令主文件
references/可选按需加载的参考文档，如风格指南、人物卡模板
assets/可选写作模板、人物关系表等辅助素材
scripts/可选可执行的辅助脚本（进阶用法）

核心设计原则

渐进式披露

FeelFish 技能采用三级信息加载机制：

  • 第一级（YAML 前置元数据）：始终注入智能体上下文。只需提供足够信息，让智能体知道何时应使用该技能，而无需把所有内容都塞进上下文。
  • 第二级（SKILL.md 正文）：当智能体判断该技能与当前任务相关时加载。包含完整的写作指令和创作指导。
  • 第三级（链接文件）：技能目录内捆绑的补充文件，智能体可以按需选择性读取，例如详细的角色设定文档或章节节奏参考。

这种渐进式披露在保留专业创作设定的同时，最大限度地减少了 Token 消耗，让长篇创作更加经济高效。

可组合性

FeelFish 支持同时激活多个技能。你的技能应该与其他技能良好协作——例如「大纲技能」和「人物技能」可以同时生效，共同指导章节扩写智能体的写作行为。

可移植性

技能以标准文件格式存储在项目目录下，可以轻松导出、分享或导入到其他 FeelFish 项目中，无需重新配置。

技能与智能体、方案的关系

理解三者关系是搭建高效创作工作流的前提：

概念类比说明
方案（Solution）编剧组决定当前项目用哪些智能体、谁主导、谁辅助
智能体（Agent）编剧成员执行具体任务的 AI 角色，有自己的职责与风格
技能（Skill）创作手册可被多个智能体复用的写作规范与流程文档

没有技能的智能体：

  • 每次对话都需要重新说明写作风格要求
  • 不同章节的人物性格、世界观细节容易出现矛盾
  • 人物对话、场景描写的风格随机漂移，缺乏一致性
  • 作者需要频繁纠正和重写

配备技能的智能体：

  • 预置的写作规范在需要时自动激活
  • 全书风格、人物性格、世界观设定始终如一
  • 最佳创作实践融入每一次交互
  • 大幅降低学习成本和来回修改时间

💡 厨房类比：智能体是掌厨的大厨，具备烹饪的工具和能力；技能是食谱，告诉大厨这道菜该怎么做、放多少料、火候几成。两者缺一不可。

第 2 章：规划与设计

从创作场景开始

在编写任何技能文件之前，先确定你的技能应支持的 2–3 个具体创作场景。

良好的创作场景定义示例：

场景名称：玄幻小说章节扩写
触发时机：用户说"帮我扩写这段情节"或"根据大纲写这一章"
步骤：
  1. 读取项目知识库中的世界观设定与人物卡
  2. 分析上一章的情节走向与伏笔
  3. 按照「起承转合」节奏展开本章内容
  4. 控制字数、视角和人物心理描写比例
结果：风格统一、设定自洽、节奏流畅的章节草稿

问自己：

  • 读者/编辑会对这一章提出什么要求？
  • 这个创作任务需要哪些多步骤工作流？
  • 需要哪些参考资料（人物卡、世界观、大纲）？
  • 应嵌入哪些写作技巧或类型规范？

常见技能用例类别

根据实际使用观察，小说创作技能通常分为以下三类：

类别 1：内容生成规范类

用途： 让智能体生成风格一致、质量稳定的小说内容，包括章节正文、人物对话、场景描写、战斗场面等。

真实示例：玄幻章节扩写技能

"按照东方玄幻的类型规范扩写章节正文。适用于用户上传大纲片段、请求'扩写这段'、'写这一章'或'帮我续写'的场景。"

关键技术：

  • 嵌入类型写作规范（如升级流、热血爽文节奏）
  • 人物性格与口吻一致性约束
  • 字数控制与段落节奏指引
  • 无需外部工具——使用 FeelFish 内置的知识库读取功能

类别 2：创作流程自动化类

用途： 适用于从固定方法论中受益的多步骤创作流程，如从世界观→大纲→章节→润色的完整创作链路。

真实示例：大纲拆解与章节规划技能

"将总大纲拆解为章节级小纲，并规划每章的核心冲突与情节节奏。适用于用户说'帮我拆大纲'、'规划这一卷的章节'或'我需要详细小纲'的场景。"

关键技术：

  • 带验证门的逐步工作流（大纲→冲突点→伏笔→章节边界）
  • 常见故事结构模板（三幕式、英雄之旅、起承转合）
  • 内置审查机制（检查章节间伏笔是否对应）
  • 迭代优化循环（根据作者反馈调整节奏）

类别 3：风格与润色类

用途： 在保留原作风格的前提下，对 AI 生成内容进行去 AI 味、风格强化、人物口吻校正等处理。

真实示例：去 AI 味润色技能

"对 AI 生成的小说内容进行润色，消除过度整齐的句式、空洞的心理描写和冗余的形容词堆砌。适用于用户说'帮我润色'、'去掉 AI 味'或'让这段更自然'的场景。"

关键技术：

  • 嵌入作者本人的语言风格样本（可放入 references/ 目录）
  • 明确列出需要避免的 AI 写作套路（如"他的心中涌起一股暖意"类句式）
  • 人物对话口吻一致性校验
  • 常见 AI 痕迹的识别与替换模式

定义成功标准

如何知道你的技能正在发挥作用？以下是可参考的评估维度：

量化指标：

  • 技能触发率： 在 10–20 个相关创作请求中，技能自动激活的比例达到 90% 以上
  • 设定一致性： 连续 5 章内，同一人物的性格描写、口头禅、技能体系无矛盾
  • 人工修改量： 与未使用技能相比，每千字需要人工修改的内容减少 50% 以上

定性指标：

  • 作者无需在每章开头重复说明写作要求
  • 智能体不会主动打破既定的世界观规则或人物设定
  • 跨多次对话，文风与叙事视角保持稳定

技术要求

文件结构

.feelfish/skills/
└── your-skill-name/
    ├── SKILL.md              # 必需——技能主文件
    ├── references/           # 可选——参考文档
    │   ├── style-guide.md    # 示例：写作风格指南
    │   ├── character-cards/  # 示例：人物卡目录
    │   └── world-settings.md # 示例：世界观设定
    └── assets/               # 可选——模板素材
        └── chapter-template.md  # 示例：章节模板

关键规则

SKILL.md 命名：

  • 必须完全匹配 SKILL.md（区分大小写）
  • 不接受任何变体（SKILL.MD、skill.md 等）

技能文件夹命名：

  • ✅ 使用短横线命名法：outline-helper
  • ❌ 禁用空格：Outline Helper
  • ❌ 禁用下划线：outline_helper
  • ❌ 禁用大写字母：OutlineHelper

无 README.md：

  • 不要在技能文件夹中包含 README.md
  • 所有说明文档应放在 SKILL.md 或 references/ 中

YAML 前置元数据：最重要的部分

YAML 前置元数据是智能体决定是否加载你技能的依据。这是技能能否被正确触发的核心，请认真编写。

最小必需格式：

---
name: your-skill-name
description: 这个技能的功能描述。当用户请求[具体触发短语]时使用。
---

字段要求：

name（必填）：

  • 仅限短横线命名法
  • 不能包含空格或大写字母
  • 必须与文件夹名称一致

description（必填）：

  • 必须同时包含：该技能的功能 + 使用时机（触发条件）
  • 少于 1024 个字符
  • 无 XML 标签（< 或 >）
  • 包含用户可能说出的具体触发短语（越贴近真实写作用语越好）

skills（可选，用于关联到智能体的 frontmatter 中）：

  • 列出要关联到该智能体的技能名称列表

metadata（可选）：

metadata:
  author: 你的笔名或团队名
  version: 1.0.0
  genre: 玄幻/都市/言情  # 适用的小说类型
  tags: [大纲, 章节扩写, 世界观]

编写有效的技能

描述字段

描述字段是智能体判断是否在当前任务中使用你技能的唯一依据。写得太模糊，技能不会被触发；写得太宽泛，会在不该用的时候触发。

结构：

[这个技能做什么] + [何时使用它] + [主要能力]

✅ 优质描述示例：

# 好——具体且包含触发短语
description: >
  按照东方玄幻类型规范扩写章节正文，保持人物性格一致、世界观自洽。
  当用户说"帮我扩写"、"写这一章"、"根据大纲写正文"或"续写"时使用。

# 好——面向流程类技能
description: >
  将小说总大纲拆解为章节级详细小纲，规划每章核心冲突、情节节奏和伏笔布局。
  当用户说"拆大纲"、"帮我规划章节"、"这卷怎么写"时使用。

# 好——面向润色类技能
description: >
  对AI生成的小说文本进行去AI味润色，消除套路句式，强化人物口吻与作者风格。
  当用户说"润色一下"、"去AI味"、"让这段更自然"、"改写这一段"时使用。

❌ 劣质描述示例：

# 太模糊
description: 帮助写小说。

# 缺少触发短语
description: 创建高质量的玄幻小说章节内容。

# 太技术化，没有用户语言
description: 实现叙事结构的分层递归拆解与角色行为约束。

编写主要指令

在前置元数据之后，用 Markdown 编写实际的写作指令。

推荐结构（以章节扩写技能为例）：

---
name: chapter-writer
description: >
  按照东方玄幻类型规范扩写章节正文，保持人物性格一致、世界观自洽。
  当用户说"帮我扩写"、"写这一章"、"根据大纲写正文"或"续写"时使用。
---

# 章节扩写技能

## 扩写前必读

在开始扩写前，请先通过知识库确认以下信息：
- 主要出场人物的性格标签与口头禅
- 本章在全书大纲中的位置（承上启下的情节功能）
- 当前世界观规则（修炼体系、地理设定等）

## 扩写步骤

### 第一步：确认章节定位
- 本章核心冲突是什么？
- 本章需要推进哪条故事线？
- 本章埋下或解开了哪些伏笔？

### 第二步：构建场景框架
1. 开场（约 10%）：时间/地点/人物状态快速交代
2. 冲突升级（约 40%）：核心矛盾逐步激化
3. 高潮（约 30%）：冲突爆发或关键转折
4. 收尾（约 20%）：情绪沉淀，为下章铺垫

### 第三步：执行扩写
- 字数目标：单章 3000–5000 字（可根据用户要求调整）
- 视角：第三人称有限视角（主角视角），除非用户另有要求
- 心理描写比例：不超过总字数的 20%

## 风格规范

- **对话**：符合人物身份与性格，避免所有人说话腔调一致
- **动作描写**：动词优先，少用副词堆砌
- **禁用套路句式**：
  - "他的心中涌起一股暖意"
  - "不知不觉间，时间已经过去了"
  - "这一刻，他明白了……"类感悟式收尾

## 质量自查

完成扩写后，自行核对：
- [ ] 人物性格是否与设定一致？
- [ ] 是否出现世界观设定矛盾？
- [ ] 章节结尾是否留有足够的悬念或钩子？
- [ ] 是否存在明显的 AI 套路句式？

## 参考资料

如需查阅详细的人物卡和世界观设定，请读取：
`references/character-cards/` 和 `references/world-settings.md`

指令最佳实践

具体且可操作：

✅ 良好示例：
扩写人物内心活动时，遵循以下原则：
- 内心独白字数不超过连续 3 句
- 使用间接心理描写（通过行为、神态暗示情绪）
- 避免直接使用"他感到悲伤/愤怒/喜悦"的陈述

❌ 不良示例：
注意描写人物内心世界。

包含错误处理：

## 常见问题处理

### 大纲信息不足
如果用户提供的大纲过于简略（少于 50 字），先向用户确认：
- 本章主要出场人物
- 本章需要完成的情节任务
- 是否有需要特别注意的伏笔

### 设定冲突
如果扩写过程中发现设定矛盾（如人物在本章出现但大纲显示其已离场），
主动告知用户，而非自行修改设定。

清晰引用捆绑资源：

在撰写战斗场景前，请读取 `references/combat-rules.md`，参考：
- 修炼等级对应的战力描述规范
- 不同功法的攻击方式与外在表现
- 战斗描写的节奏控制建议

第 3 章：测试与迭代

根据你的需求，技能可以在不同严谨性级别下进行测试：

  • 在 FeelFish 中手动测试：直接发出创作请求，观察智能体行为。快速迭代，无需额外设置。
  • 多场景覆盖测试：准备多个不同类型的测试请求，验证技能在不同写作场景下的表现。
  • 跨章节连贯性测试：连续完成 3–5 章，检验设定一致性与风格稳定性。

💡 专业提示：先在单个难度较高的场景上迭代。找一个容易出问题的典型任务（如含多人物复杂对话的高潮场景），反复调整直到满意，然后再推广到更多场景测试覆盖。

推荐的测试方法

1. 触发测试

目标： 确保技能在正确的时机被智能体加载。

测试用例设计：

应该触发的请求：
✅ "帮我把这段大纲扩写成正文"
✅ "根据下面的小纲写这一章"
✅ "续写上一章，接着写追击场景"
✅ "这段情节太短了，帮我丰富一下"

不应该触发的请求：
❌ "帮我改一下这段话的语法"（应触发润色技能）
❌ "分析一下这本书的主题思想"（分析类，非扩写）
❌ "给我推荐几本玄幻小说"（查询类，与创作无关）

调试方法： 直接问智能体："你什么时候会使用 [技能名称] 技能？"智能体会根据描述字段作答，你可以据此判断描述是否准确。

2. 功能测试

目标： 验证技能能产生符合预期的创作输出。

测试：扩写含双人对话的冲突场景

前置条件：
- 人物 A：傲慢、惜字如金的宗门长老
- 人物 B：倔强、口无遮拦的主角
- 场景：A 刁难 B 的入门测试，B 怒而反击

预期结果：
- A 的对话简短、带有居高临下的语气
- B 的对话直接、有情绪起伏
- 两人说话风格明显区分
- 无"他的心中涌起一股热血"类套路收尾
- 章节末有悬念钩子（如 B 激活了意外的隐藏天赋）

3. 设定一致性测试

目标： 验证技能在跨章节创作中能保持世界观和人物设定的自洽性。

基准对比：

未使用技能时：
- 第 3 章主角使用"御剑术"飞行
- 第 7 章出现主角徒步翻山越岭（遗忘了飞行能力）
- 每章末尾都用"他深吸一口气"作为收尾句

使用技能后：
- 主角能力与设定保持连贯
- 不同人物的口吻稳定区分
- 作者风格标签（如"简洁动作流"）在各章均有体现

基于反馈的迭代

技能是活文档，计划根据以下信号持续更新：

触发不足信号：

  • 技能未被自动加载（需要手动在对话中说明要求）
  • 智能体经常忘记关键的写作规范
  • 需要反复提醒人物的性格或口吻

解决方案： 在 description 中添加更多贴近真实写作用语的触发短语；在 SKILL.md 正文中将关键规范提到最前面。

过度触发信号：

  • 技能在不相关的对话中加载（如简单问答也触发了扩写规范）
  • 智能体在用户只想改一个错别字时也启动了完整扩写流程

解决方案： 在 description 中添加负面说明，明确区分适用与不适用的场景。

description: >
  扩写章节正文内容。当用户请求"扩写"、"写正文"、"写这一章"时使用。
  【注意】不适用于：仅修改语法错误、简短润色（3句以内）、
  查询性问题。

执行质量问题：

  • 风格规范被遵循，但章节结构仍然混乱
  • 人物对话符合口吻，但情节推进过慢

解决方案： 在 SKILL.md 中增加结构化的自查清单；将模糊的风格描述改为可量化的执行标准（如"对话场景中，每段对话控制在 30 字以内，配合 1–2 句动作描写"）。

第 4 章：分发与共享

技能让你的创作工作流可以被复用、分享和标准化。配备技能的 FeelFish 创作方案比纯粹的提示词调整提供了更快的价值实现，是网文工作室和创作社群内知识传递的有效载体。

当前分发模型

个人用户如何获取和安装技能：

  1. 下载技能文件夹（或 ZIP 压缩包）
  2. 在 FeelFish 的「技能」标签页点击「从本地导入」
  3. 选择技能文件夹（需包含 SKILL.md）
  4. 在「智能体」编辑界面将技能关联到对应的智能体

团队/工作室技能共享：

  • 将技能文件夹提交到团队共享的 Git 仓库
  • 团队成员拉取后通过「从本地导入」安装
  • 更新技能时，通知成员重新导入最新版本

市场分发：

  • 通过 FeelFish 资源市场「分享到市场」发布
  • 其他用户可一键下载应用，无需手动导入

一个开放的创作标准

FeelFish 的技能遵循开放的 Skill 标准设计，与主流 AI 编写协议兼容。这意味着你精心设计的创作技能不只属于某一个工具——你在 FeelFish 中积累的写作规范和工作流知识，未来可以迁移和复用。

作者可以在技能的 metadata 字段中注明适用的平台或类型，供其他用户参考。

推荐发布方式

在 FeelFish 资源市场中发布，你在 FeelFish 中创建完成技能后，可以发布到资源市场。

方便在其它项目中复用。

定位你的技能

你如何描述你的技能决定了其他作者是否理解其价值并真正尝试使用它。

关注创作成果，而非技术功能：

✅ 良好示例：
"用这个技能，你的玄幻章节扩写将自动遵循修炼等级体系、
人物口吻规范和爽文节奏——不用每次都重复说明，
AI 替你记住所有设定。"

❌ 不良示例：
"这个技能包含 YAML frontmatter 和 Markdown 指令，
通过智能体上下文注入实现写作约束。"

突出「技能 + 智能体」组合的价值：

"FeelFish 的智能体让 AI 具备了写作的能力，
我们的技能教会它你的写作方式。
两者结合，才能实现真正属于你的 AI 创作工作流。"

第 5 章：模式与故障排除

以下模式来源于实际小说创作场景中的观察与总结，代表在不同类型、不同写作阶段中被验证有效的常见方法，而非一成不变的模板。

选择你的方法：问题优先 vs 工具优先

这就像找编辑老师改稿。你可能带着一个具体的问题来——"这章的高潮场景太平了，帮我改"——然后老师根据问题给出修改策略。或者，你主动告诉老师你今天想练习"战斗场景中的心理描写"，老师会把这个方向应用到所有需要的地方。

技能的工作方式也是如此：

  • 问题优先："这章节奏太快，人物情绪没铺开" → 你的技能以正确的顺序引导智能体处理节奏和情绪层次。作者描述问题，技能提供方案。
  • 工具优先："我已经配置好了人物卡和世界观" → 你的技能教导智能体如何充分利用这些设定，写出最贴合的内容。作者提供素材，技能提供专业知识。

模式 1：线性创作流程编排

使用场景： 当你需要按固定顺序完成多步骤创作任务时，例如「大纲→小纲→正文→润色」的完整写作链。

示例结构：

# 完整章节创作流程

## 步骤一：大纲确认
- 读取本章在总大纲中的位置
- 确认：核心冲突、出场人物、需完成的情节任务

## 步骤二：小纲展开
- 将章节任务拆解为 5–8 个场景节点
- 每个节点包含：场景位置、参与人物、情节功能

## 步骤三：正文扩写
- 按小纲逐场景扩写
- 控制字数：每场景 400–800 字

## 步骤四：质量自查
- 检查人物口吻一致性
- 检查伏笔是否有头有尾
- 检查章末悬念是否到位

关键技术：

  • 显式步骤排序，防止智能体跳步
  • 步骤间的依赖关系（下一步依赖上一步的输出）
  • 各阶段的验证清单
  • 失败回退指令（如"如果大纲信息不足，先向用户确认"）

模式 2：多智能体协同创作

使用场景： 创作任务跨越多个专业角色时，例如「规划智能体」负责大纲，「创作智能体」负责正文，「润色智能体」负责去 AI 味。

示例：章节从零到完稿的多智能体流程

# 阶段一：规划智能体（大纲与结构）
1. 分析用户提供的章节要求
2. 生成本章小纲（场景节点列表）
3. 标注关键情节功能（埋线/揭线/角色弧进展）

# 阶段二：创作智能体（正文扩写）
1. 接收规划智能体输出的小纲
2. 按风格规范扩写各场景
3. 输出初稿，并附上自查说明

# 阶段三：润色智能体（风格优化）
1. 接收创作智能体的初稿
2. 执行去 AI 味润色
3. 校对人物口吻与作者风格标签
4. 输出终稿

关键技术：

  • 清晰的阶段边界（每个智能体专注一个角色）
  • 智能体间的数据传递规范（输入/输出格式约定）
  • 进入下一阶段前的验证（如"初稿字数不足 2000 字时，回到第二阶段补充"）

模式 3：迭代优化创作

使用场景： 输出质量通过多轮反馈逐步提升，适合对文风要求极高的作者或需要反复打磨高潮场景的情况。

示例：关键战斗场景迭代创作

# 第一轮：框架草稿
1. 生成战斗场景基本框架（起因、经过、结果）
2. 保存为草稿

# 质量评估
检查以下问题：
- 战斗节奏是否紧张（动词密度是否足够）？
- 双方实力对比是否合理？
- 主角的危机感是否充分传递？

# 第二轮：针对性扩写
1. 针对评估中发现的薄弱环节进行补写
2. 加强动作描写的速度感
3. 增加主角面临绝境时的心理层次

# 第三轮：润色收尾
1. 去除冗余的副词和形容词堆砌
2. 检查战斗逻辑的自洽性
3. 确认高潮节点的视觉冲击力

关键技术：

  • 明确的质量评估标准
  • 每轮针对性而非全量修改
  • 知道何时停止（不因过度打磨而失去原有灵气）

模式 4：类型感知内容生成

使用场景： 根据小说类型自动切换对应的写作规范，例如玄幻、都市、言情、悬疑各有不同的节奏与描写偏好。

示例：类型自适应写作

# 类型检测与规范切换

## 判断流程
1. 确认当前小说类型（从项目知识库或用户说明中获取）
2. 加载对应的类型写作规范：
   - 玄幻：升级爽感、战斗节奏、修炼体系描写
   - 都市：现实质感、人情世故、职场/商战逻辑
   - 言情：情感节奏、人物互动细节、心理描写比重
   - 悬疑：信息控制、线索埋设、节奏张力

## 类型规范执行
- 应用对应类型的章节节奏模板
- 调整心理描写与动作描写的比例
- 匹配对应类型读者的期待节点

关键技术：

  • 清晰的类型判断依据
  • 每种类型的差异化写作规范
  • 备用选项（类型不明确时的通用规范）

模式 5：领域知识嵌入

使用场景： 当你的技能需要提供超出通用写作能力的专门知识时，例如特定历史背景、专业职场逻辑、特定地域文化细节。

示例：古代宫廷礼仪约束

# 古代宫廷场景写作规范

## 人物称谓规范
- 皇帝：圣上、陛下（臣子用），皇儿（太后用），朕（自称）
- 皇后：娘娘、皇后娘娘
- 贵妃：娘娘（称呼）、本宫（自称）

## 礼仪行为规范
- 觐见场景必须包含：进殿、行礼（跪拜/颔首取决于身份）、起身
- 后宫妃嫔在皇帝面前不得主动落座，需皇帝赐座
- 太监通报必须说"奴才"，宫女自称"婢子"

## 常见错误规范
- 避免：妃嫔直接叫皇帝名字
- 避免：臣子在御前大声争吵（应为"冒死直谏"式表达）
- 避免：现代词汇混入对话

关键技术：

  • 领域专业知识以可操作的规范形式呈现
  • 先约束后创作（规范优先于内容生成）
  • 详细的常见错误清单

故障排除

技能无法导入

错误："无法找到 SKILL.md"

原因：文件未准确命名为 SKILL.md

解决方案：

  • 重命名为 SKILL.md（区分大小写）
  • 确认文件直接位于技能文件夹根目录下

错误："无效的前置元数据"

原因：YAML 格式问题

# 错误——缺少分隔符
name: my-skill
description: 扩写章节

# 错误——引号未闭合
description: "扩写章节内容

# 正确
---
name: my-skill
description: 扩写章节内容，当用户说"帮我写这章"时使用。
---

错误："无效的技能名称"

原因：名称包含空格或大写字母

# 错误
name: 章节扩写技能
name: ChapterWriter

# 正确
name: chapter-writer

技能未触发

症状： 技能从未自动加载，智能体不知道有这个技能

修复方案： 修改你的 description 字段。

快速检查清单：

  • 是否包含用户实际会说的中文口语触发短语？（"帮我扩写" 比 "执行章节扩写任务" 更有效）
  • 是否过于笼统？（"帮助写作"无效）
  • 技能是否已在对应智能体中完成关联？

调试方法：直接问智能体："你什么时候会使用 [技能名] 技能？"根据回答判断描述是否需要调整。

技能触发过于频繁

症状： 智能体在用户只想改一个错别字时，也启动了完整的扩写流程

解决方案：

  1. 添加负面触发说明：
description: >
  扩写章节正文内容，当用户请求"扩写"、"写这一章"时使用。
  【不适用】：仅修改语法/错别字、简短润色（3句以内）、
  提问或查询类请求。

  1. 更加具体地描述触发场景

  2. 明确区分不同技能的边界（如润色技能与扩写技能互不干涉）

指令未被遵循

症状： 技能已加载，但智能体不遵循写作规范（如仍使用禁用句式）

常见原因：

  1. 规范描述过于模糊
❌ 模糊指令：
避免 AI 感的句子。

✅ 明确指令：
【禁止使用以下句式】：
- "他的心中涌起一股……"
- "这一刻，他终于明白了……"
- "不知不觉间，时间流逝"
- 任何以"感悟式总结"结尾的段落
  1. 关键规范被埋在文档深处

解决方案：将最重要的约束放在 SKILL.md 正文最顶部，使用 ## ⚠️ 重要 或 ## 核心规范 等标题突出显示。

  1. SKILL.md 内容过长

解决方案：将详细参考资料移至 references/ 目录并提供链接，保持 SKILL.md 核心指令简洁（建议控制在 2000 字以内）。

大上下文问题

症状： 长篇创作中，技能的约束效果逐渐减弱

原因：

  • 技能内容本身过大，占用太多上下文窗口
  • 同时启用了过多技能，相互干扰
  • 所有参考文档一次性加载，而非渐进式

解决方案：

  1. 优化 SKILL.md 文件大小——将详细的人物卡、世界观等移至 references/，在需要时才读取
  2. 合理控制同时启用的技能数量——对于长篇小说，按写作阶段切换不同的技能组合（起笔阶段 vs 打磨阶段）
  3. 利用渐进式披露的设计——仅在 SKILL.md 正文中保留核心规范，细节通过工具按需读取

第 6 章：资源与参考文献

官方文档

FeelFish 资源：

示例技能

推荐从以下场景着手：

  • 资源市场中浏览他人分享的方案和技能，寻找适合你类型的模板
  • 下载后导入本地，根据你的具体项目进行微调
  • 使用「智能上下文」功能分析已有优质小说的结构，转化为技能规范

工具与实用程序

FeelFish 内置能力：

  • 知识库：存储人物卡、世界观、时间线等长期设定，供技能随时调用
  • 智能上下文：可以用于自动基于已有内容总结
  • 资源市场：浏览、下载、分享方案、智能体与技能

获取支持：

  • 加入 FeelFish 社群，与其他作者交流技能使用心得
  • 在资源市场中搜索已有技能，避免重复造轮子
  • 通过「分享到市场」贡献你的技能，帮助更多创作者

附录 A：快速检查清单

使用此清单在技能创建前后验证你的工作。

开始之前

  • 已确定 2–3 个具体创作场景
  • 已确认需要哪些参考资料（人物卡、世界观、风格样本）
  • 已规划文件夹结构

开发期间

  • 文件夹名称采用短横线命名法（小写字母+数字+连字符）
  • SKILL.md 文件存在（拼写和大小写完全正确）
  • YAML 前置元数据包含 --- 分隔符
  • name 字段：短横线命名法，无空格，无大写字母
  • description 包含功能描述和触发时机
  • 无 XML 标签（< >）
  • 写作规范具体且可执行（不只是模糊的风格要求）
  • 包含常见错误处理指引
  • 参考资料链接清晰，放在 references/ 目录下

上传/导入前

  • 测试触发：发出 5 个相关创作请求，确认技能被加载
  • 测试非触发：发出 3 个不相关请求，确认技能未被误触发
  • 功能测试：完成一个完整的创作任务，检查输出质量
  • 设定一致性测试：连续两章，确认人物口吻和世界观自洽

导入后

  • 在真实创作对话中测试效果
  • 监控触发不足/过度触发信号
  • 收集实际创作中的问题反馈
  • 基于反馈迭代描述和指令
  • 在 metadata 中更新版本号

附录 B：YAML 前置元数据参考

必填字段

---
name: skill-name-in-kebab-case
description: 这个技能的功能，以及当用户说[具体触发短语]时使用。
---

所有可选字段

---
name: chapter-writer
description: >
  按照东方玄幻规范扩写章节正文，保持人物性格和世界观一致。
  当用户说"帮我扩写"、"写这一章"或"续写"时使用。
metadata:
  author: 你的笔名
  version: 1.0.0
  genre: 玄幻
  tags: [章节扩写, 东方玄幻, 人物一致性]
  documentation: https://github.com/yourname/feelfish-skills
---

安全注意事项

允许：

  • 任何标准 YAML 类型（字符串、数字、布尔值、列表、对象）
  • 自定义 metadata 字段
  • 较长的 description（最多 1024 个字符，可使用 > 多行格式）

禁止：

  • XML 尖括号（< >）——安全限制
  • 技能名以"Claude"或"Anthropic"为前缀（保留）

附录 C：完整技能示例

以下是一个可直接使用的完整技能示例，演示本指南中讨论的核心模式：

---
name: xianxia-chapter-writer
description: >
  按照东方玄幻类型规范扩写章节正文，维持修炼体系自洽、人物口吻一致、
  爽文节奏流畅。当用户说"帮我扩写"、"写这一章"、"根据大纲写正文"、
  "续写"或"把这段写详细"时使用。不适用于：修改错别字、简短润色、
  纯粹的查询类问题。
metadata:
  author: FeelFish 示例
  version: 1.0.0
  genre: 东方玄幻
  tags: [章节扩写, 玄幻, 修炼体系]
---

# 东方玄幻章节扩写技能

## ⚠️ 扩写前必读

开始扩写前，请先通过知识库确认：
- 主要出场人物的性格标签与口头禅
- 当前修炼体系（等级划分、技能外在表现）
- 本章在全书大纲中的情节功能

如知识库中无相关设定，向用户简要确认后再开始。

## 扩写规范

### 结构节奏

| 部分 | 比例 | 功能 |
|------|------|------|
| 开场 | 10% | 时间/地点/人物状态，快速入戏 |
| 冲突升级 | 40% | 核心矛盾逐步激化 |
| 高潮 | 30% | 冲突爆发或关键转折 |
| 收尾 | 20% | 情绪沉淀，为下章钩子铺垫 |

### 写作规范

**字数目标：** 单章 3000–5000 字（可按用户需求调整）

**视角：** 第三人称有限视角（主角视角），除非用户另有说明

**心理描写比例：** 不超过总字数的 20%

**对话规范：**
- 不同人物的口吻必须有明显区分
- 对话不超过连续 4 句，穿插动作/神态描写
- 禁止所有人物说话方式千篇一律

### 禁用句式清单

以下为明确禁止使用的 AI 套路句式：

- "他的心中涌起一股……"
- "这一刻，他终于明白了……"
- "不知不觉间，时间已经流逝"
- "他深吸一口气"（作为段落收尾）
- "眼中闪过一丝……"（情绪外化套路）
- 任何以"感悟总结"结尾的段落

## 质量自查清单

完成扩写后，逐项核对：

- [ ] 人物性格与知识库设定一致？
- [ ] 修炼等级与战力描写符合体系规则？
- [ ] 是否存在世界观设定矛盾？
- [ ] 章节末尾是否留有悬念/钩子？
- [ ] 是否存在禁用句式？

## 参考资料

如需查阅详细设定，请读取：
- `references/character-cards/` ——人物卡目录
- `references/world-settings.md` ——世界观与修炼体系
- `references/combat-rules.md` ——战斗场景写作规范

## 常见问题处理

### 大纲过于简略
如用户提供的大纲少于 50 字，先确认：
1. 本章主要出场人物
2. 本章需要完成的情节任务
3. 是否有需要埋设或揭开的伏笔

### 发现设定矛盾
如发现当前内容与已有设定冲突，**不要自行修改设定**，
而是告知用户："我注意到 [具体矛盾]，请确认如何处理？"

以上示例可从 FeelFish 资源市场获取，也可在社区技能分享区找到各类型的完整技能模板，包括：

  • 都市职场类：商战逻辑约束技能
  • 古言言情类：宫廷礼仪与称谓规范技能
  • 悬疑推理类：线索埋设与信息控制技能
  • 通用润色类：去 AI 味与风格强化技能

克隆或下载这些技能，根据你的具体项目进行修改，将其作为你个人创作工作流的起点。

本指南由 FeelFish 创作社区整理，基于 FeelFish 3.0.0+ 版本的技能系统编写。如有疑问，欢迎访问 FeelFish 官方文档 或加入创作社群交流。