| name | fic-init |
| description | 初始化同人写作项目,建立目录、默认模式、reviewer 配置和初始 story bible。 |
fic-init
作用
初始化项目工作区,建立默认文件、模式、reviewer、记忆挂载点和初始 story bible。适合新项目开工,或将旧项目迁入本框架。
何时使用
- 第一次在该工作区开始 fanfic 项目时
- 已有零散设定,但没有统一结构和状态文件时
- 想把一个现有同人项目迁入 OpenClaw / 纯文件 workflow 时
预期输入
- 项目标题、premise、主要 IP、可选 crossover IP
- 运行模式:human_assisted / full_auto / mixed
- 用户是否已经写了前 1–3 章
- reviewer 严格度偏好、是否启用 human checkpoint
- 是否检测并适配 ClawXMemory / memory-wiki
预期输出
- 基础目录结构与关键模板文件
- 更新后的 story-bible/project-meta.md
- 初始化后的 state/STORY_STATE.json、REVIEW_STATE.json、BRANCH_STATE.json
- 初始 assumptions 与风险清单
执行流程
- 读取
story-bible/project-meta.md、state/ 与根目录关键文件,判断项目是否已经初始化;若已初始化,做增量补全而不是覆盖。
- 若缺少目录或模板文件,按本框架标准补齐,但不得删除用户已有内容。
- 把用户提供的 premise、IP、模式、checkpoint 偏好写入
story-bible/project-meta.md 与 state/STORY_STATE.json。
- 初始化
reviews/、compact/、story-bible/ 的空模板;若检测到用户已有章稿,在 project-meta.md 记录为 human-assisted 起点。
- 输出一份
docs/assumptions.md 增量补充,明确哪些信息尚未知、后续应由哪个 skill 负责补全。
- 将
next_recommended_skill 指向最合理的下一步:通常是 canon-ingest 或 human-ingest。
硬规则
- 不得覆盖用户已有章节和已确认设定。
- 不得把未知 canon 直接写成既定事实。
- 初始化只负责立骨架,不负责代写大纲或正文。
- 若检测到跨作项目,必须标记 crossover 风险,而不是假装天然兼容。
人类检查点
若项目已经存在大量自定义结构,或用户已有前三章但未明确是否允许续写,建议先做人工确认。否则可自动继续。
恢复与续跑
任何初始化动作都必须幂等:重复执行时只补缺、不重置。完成后更新 state/STORY_STATE.json.last_completed_skill = 'fic-init',并在 next_recommended_skill 中指向后继步骤。
返回格式
返回:1) 已创建 / 补齐的文件;2) 已识别项目模式;3) 关键未知项;4) 建议下一步。
关键文件
- story-bible/project-meta.md
- docs/assumptions.md
- state/STORY_STATE.json
- state/REVIEW_STATE.json
- state/BRANCH_STATE.json
最小示例
- 从一句 premise 开一个 Fate 穿越坑
- 把已有 3 章用户手稿接入续写 workflow
- 把月姬 × Guilty Gear 的旧笔记迁入本仓库