mcpField
P
project-setup

project-setup

github.com/haowjy创意与媒体552549 次安装2 天前更新
代码仓库

关于 project-setup

用于小说项目的设置技能,可建立项目约定、知识库目录结构,并在有写作样本时创建风格文件。它引导作者了解项目情况、审阅方案,并按确认内容创建项目文件。

主要功能

  1. 01按环境提供设置流程
  2. 02了解项目与写作样本
  3. 03起草 AGENTS.md 项目约定
  4. 04创建知识库与工作目录
  5. 05可选创建风格文件

适用场景

  1. 01启动新的小说或故事项目
  2. 02整理现有的虚构创作项目
  3. 03准备写作样本以进行风格分析

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/haowjy/creative-writing-skills --skill project-setup

安装后在 Claude Code 中输入/project-setup确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

resources/
claude-code.md
claude-desktop.md
meridian-cli.md
other-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 应避免使用或加以区分的术语。

展示草稿,并允许作者不断调整,直到满意为止。

创建文件

获得批准后:

  1. 按照双方商定的内容编写或更新 AGENTS.md。
  2. 创建其中列出的 kb/ 目录。
  3. 如果项目中有需要 Agent 统一使用的命名概念,就创建 kb/vocab.md;当某个领域已有足够多的专有术语时,再添加该领域的词汇文件。
  4. 创建 work/,并在其中创建 outline/、drafts/、critique-reports/ 和 brainstorm/。
  5. 将写作样本保存到 kb/samples/。
  6. 如果作者提供了样本并希望创建风格文件,就在 kb/styles/ 中生成初始风格文件。

现有项目

如果 AGENTS.md 已包含创意写作约定,就先阅读并提出更新建议。不要覆盖作者已经做出的决定。

评论

支持 Markdown