Story Skills
用 Markdown 规划、撰写并检查长篇故事连续性。
- Star 数
- ★ 288
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 80/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeClaude.ai（部分支持）
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 独立小说作者想在 Markdown 项目里记录角色、地点、线索和章节，并通过版本控制管理修改。
- 不适合
- 只想在网页界面中写作、无需管理本地文件的作者
- 需要协作式在线编辑器的团队
- 源码审查
- 80/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Story Skills 为小说创作提供一套共享的 Markdown 项目格式，涵盖故事圣经、角色、世界观、情节、场景、连续性状态和章节草稿。它包含 24 项 Agent Skills，可作为 Codex 或 Claude Code 插件安装，也可供支持 `SKILL.md` 的其他代理使用。可选的 `story` CLI 负责确定性维护：验证文件和链接、检查连续性、整理上下文并导出或构建稿件。角色死亡、承诺与回报、未解问题以及物品和知识状态记录在 YAML frontmatter 中，连续性检查会报告矛盾。项目以本地文件和命令行方式工作；README 还提供 GitHub Actions 模板，可定时起草章节并通过拉取请求审阅。
作者先用 story init 建立项目，或用 story import 从现有稿件导入；项目以 story.md、实体 Markdown 文件及 _index.md 注册表保存设定和稿件。相应技能可创建角色和世界设定、规划情节、起草章节、修订并整理投稿或出版材料。CLI 的 story validate、story links 和 story continuity 检查格式、引用和故事状态，story check 可一次运行验证、链接和连续性检查。其他命令可打包章节上下文、跟踪进度并导出或构建 EPUB、DOCX、印刷稿、HTML 审阅稿、剧本以及 Twine 和 ink 格式。
- 独立小说作者想在 Markdown 项目里记录角色、地点、线索和章节，并通过版本控制管理修改。
- 悬疑或奇幻作者需要检查角色是否在死亡后重现、线索回报是否早于铺垫，以及物品状态是否矛盾。
- 已有章节草稿的作者想用
story import拆分章节并建立故事注册表。 - 用 Codex、Claude Code 或其他支持
SKILL.md的代理工作的作者，需要从构思、规划到修订和投稿的一套写作技能。 - 自出版作者希望从同一项目构建 EPUB、DOCX、印刷内页或 HTML 审阅稿。
- 连载或系列作者需要记录跨章节状态，并维护前传、续作之间的共享设定。
如何安装或部署这个 Agent？
Codex 插件安装命令：
codex plugin marketplace add danjdewhurst/story-skills
codex plugin add story-skills@story-skillsClaude Code 插件安装命令（在 Claude Code 会话中执行）：
/plugin marketplace add danjdewhurst/story-skills
/plugin install story-skills@story-skills支持 SKILL.md 的其他代理可用 Agent Skills CLI 安装：
npx skills add danjdewhurst/story-skills可选 CLI 需要 Node.js 18 或更高版本；也可用 npm 全局安装：
npm install -g story-skills如何使用这个 Agent？
安装技能后，在代理中请求“Start a new story”以开始新项目。也可直接用 CLI 初始化项目：
story init "The Last Ember"导入已有稿件并运行检查：
story import draft.md --title "The Lost Coast" --genre mystery
story check --strict从项目构建 EPUB：
story build [path] --format epub也可使用 npx story-skills --help 查看 CLI 帮助。README 未要求用于普通本地创作的 API 密钥；GitHub Actions 的定时起草模板需要配置 ANTHROPIC_API_KEY。
这个 Agent 有哪些优点和局限？
- 24 项技能覆盖构思、规划、起草、修订、投稿和出版，且以共享项目文件交接。
- 连续性信息写入 YAML frontmatter，CLI 能报告角色死亡、线索时序和状态冲突等具体问题。
- Markdown 项目可在任意编辑器中打开和进行 Git 差异比较；同一项目支持多种稿件导出和构建格式。
- 支持多语言和文字方向，包括右至左文字以及纵排中文、日文和韩文构建。
- 写作项目由本地 Markdown 文件组成，需要作者管理文件和命令行工作流；README 没有描述网页编辑器。
- 使用可选 CLI 需要 Node.js 18 或更高版本；不装 CLI 时无法使用其确定性检查和构建命令。
- 技能虽可用于支持
SKILL.md的代理，但具体安装方式因代理而异；README 明确列出 Codex 和 Claude Code 的插件安装流程。 - 定时自动起草工作流依赖 Claude Code Action，并要求配置
ANTHROPIC_API_KEY。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Story Skills 当前 | 80 · 表现良好 | Agent 插件 / 技能免费 | ★ 288 | 1 天前 | JavaScript | Codex · Claude Code |
| InkOS 故事创作工作台 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 10k | 今天 | TypeScript | Claude Code · OpenAI API · Claude API |
| PaperOrchestra 技能包 | 62 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 680 | 19 天前 | Python | Claude Code |
| Patina 多语言文本润色器 | 83 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 366 | 11 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
工作流权限限定为读取内容，发布和草稿自动化的外部动作有明确说明；草稿通过 PR 交由审阅，且说明了 API 密钥、公开 Pages 风险和发布验证方式，因此数据流与外部影响交代充分。扣分在于现有材料没有覆盖每项技能写文件或触发外部动作时的确认规则，也未说明作品内容等敏感数据如何在所有集成中处理；回滚主要依赖普通 Git 工作流，未见专门恢复机制。包作者和许可证信息清楚，但发布者身份未获验证，维护责任的个人或团队承诺有限。
README、包元数据和工作流一致地描述 markdown 项目、CLI 与技能的分工，提供 CI、示例校验、回归用例及跨平台检查。扣分在于这些材料不能证明本次审查修订的实际运行结果；运行时没有依赖的声明有包元数据支持，但安装仍涉及 Bun、Node、安装工具或外部构建工具；错误示例可读，但没有足够材料覆盖一般安装失败和技能失败时的处理。
材料面向小说作者，列出从构思到出版的多种场景、多个 Agent 环境、语言和输出格式，并明确 CLI 负责确定性维护、技能负责创作。扣分在于技能触发主要用示例请求描述，缺少边界冲突或误触发的系统性说明。
文档索引、项目结构、安装步骤、命令参考、示例项目、开发指南、安全政策和 MIT 许可证均有清晰入口。扣分在于材料不足以验证命名在长期发布中的稳定性；限制说明虽涉及 Node 版本、脚本与私有 Pages 等要点，但不构成完整限制清单；有版本号和变更日志入口，却未在提供的材料中呈现具体变更记录；安全报告路径明确，但持续维护承诺有限。
技能目录、项目模板、连续性检查示例和多种导出格式说明了可直接使用的成果；结构化状态与确定性 CLI 检查为长篇连续性提供了明确增益。扣分在于节省的时间或改善程度没有独立证据，完整工作流涉及安装 CLI、维护 frontmatter 和学习项目格式，普通使用有一定成本。
README 给出具体 CLI 输出，测试文件展示对应领域的断言，CI 工作流列出校验步骤，安全文档描述发布验证机制，多个关键主张可追溯到源文件。扣分在于当前材料中的 README、测试、工作流不能独立确认实际发布物或本修订的运行状态；文档中产品主张和可由所给文件验证的事实虽有区分线索，但没有统一标记两者。
- 自动草稿流程需要配置 ANTHROPIC_API_KEY；README 提醒 GitHub Pages 默认可能公开，请在发布审阅副本前核实项目可见性。
- Windows CI 工作流会在一次性托管 runner 上尝试关闭 Defender 实时监控；材料明确警告不要将该步骤复制到自托管 runner。
常见问题
必须安装 CLI 才能使用写作技能吗？
story CLI 是可选的项目维护工具。连续性检查具体会检查什么？
运行 CLI 需要什么环境？
定时自动写章节需要什么？
ANTHROPIC_API_KEY，并为稿件拉取请求进行审阅。