关于 project-setup
用于小说项目的设置技能,可建立项目约定、知识库目录结构,并在有写作样本时创建风格文件。它引导作者了解项目情况、审阅方案,并按确认内容创建项目文件。
主要功能
- 01按环境提供设置流程
- 02了解项目与写作样本
- 03起草 AGENTS.md 项目约定
- 04创建知识库与工作目录
- 05可选创建风格文件
适用场景
- 01启动新的小说或故事项目
- 02整理现有的虚构创作项目
- 03准备写作样本以进行风格分析
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ haowjy/ creative-writing-skills --skill project-setup安装后在 Claude Code 中输入/project-setup确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
resources/claude-code.mdclaude-desktop.mdmeridian-cli.mdother-harnesses.md详细介绍
项目设置
只需设置一次项目,让之后的每次会话都能遵循所需约定:AGENTS.md、kb/ 目录结构,以及作者有写作样本时所需的风格文件。
首先,加载一份环境指南
询问作者使用哪种环境,或根据会话推断,然后只阅读以下其中一份,并按照其中的设置说明和操作指南进行:
resources/meridian-cli.md— meridian-cli,使用mars add安装软件包。resources/claude-code.md— 使用此插件的 Claude Code。resources/claude-desktop.md— claude.ai、Claude Desktop 或 Cowork。resources/other-harnesses.md— Codex、Cursor、OpenCode 或 Grok。
不要加载其他文件。写作应用 Meridian Flow 目前还没有设置流程:它会在导入器发布后导入软件包,因此请使用你当前所在的环境。
了解项目
询问以下内容:
- 项目类型:长篇小说、短篇小说集,还是连载?
- 项目进度:刚开始,还是已经有章节和世界观设定?
- 单 POV 还是多 POV?时间线是线性还是非线性?世界观设定有多丰富?
- 作者在哪里保存作品?现有目录结构是什么?
写作样本与风格
写作样本是风格分析的基础:
- 是否已经写好样章或场景?
- 是否有其他项目的作品能体现他们想要的文风?
- 是否有希望借鉴其风格的已出版作品?
- 文风目标:贴近人物的第三人称、全知视角,还是第一人称?正式还是口语化?
收集作者现有的材料,并保存到 kb/samples/。如果材料足够,可以提出使用 /creative-writing-craft 进行分析:阅读样本,识别文风维度,并在 kb/styles/ 中编写初始风格文件。尽早做好风格文件影响最大;每个写作 Agent 都依赖这些文件。
如果作者刚开始写作,就在 AGENTS.md 中记录其文风目标,以便从初稿开始创建风格文件。
提出方案并迭代
起草 AGENTS.md 并展示给作者。内容包括:
- 项目概述:用一段话说明项目内容。
- 作者的创作空间:作者在哪里保存作品,以及如何组织。Agent 会从这里读取内容,但不会写入。
- 知识库结构:说明
kb/下有哪些子目录,以及各自的用途。加载/story-memory;其resources/kb-layout.md包含各层级、页面约定和默认目录结构。选择适合此项目的子集:简单(短篇小说、单 POV)、中等(长篇小说、少数 POV)或复杂(系列作品、大型世界观)。 - 文风与风格:有哪些风格文件、基于哪些样本,以及尚未体现的文风目标。
- 约定:命名规则、章节编号、POV 标记、剧透处理,以及其他项目特有事项。
- 共享词汇:早期定下的规范术语、别名、创造词汇、具有项目特定含义的类型术语,以及 Agent 应避免使用或加以区分的术语。
展示草稿,并允许作者不断调整,直到满意为止。
创建文件
获得批准后:
- 按照双方商定的内容编写或更新
AGENTS.md。 - 创建其中列出的
kb/目录。 - 如果项目中有需要 Agent 统一使用的命名概念,就创建
kb/vocab.md;当某个领域已有足够多的专有术语时,再添加该领域的词汇文件。 - 创建
work/,并在其中创建outline/、drafts/、critique-reports/和brainstorm/。 - 将写作样本保存到
kb/samples/。 - 如果作者提供了样本并希望创建风格文件,就在
kb/styles/中生成初始风格文件。
现有项目
如果 AGENTS.md 已包含创意写作约定,就先阅读并提出更新建议。不要覆盖作者已经做出的决定。
评论
支持 Markdown