story-setup

What problem does it solve?

在开始写作之前，缺少统一的 Agents/Hooks/Rules/指令环境会导致后续拆文、写作、去AI味等流程无法正常运行。该技能通过在用户工作目录中完成基础设施部署，确保整个写作工具链可用且可持续升级。

Core Features & Use Cases

• 写作环境一键部署（不覆盖）：探测现有文件状态后，只部署缺失项（Agent、Hooks、AGENTS.md、规则模板、上下文模板），尽量不打扰用户自定义内容。
• opencode.json 增量合并（只增不改）：将模板中的 instructions/skills/agent/command 按规则追加到用户现有配置中，避免覆盖原配置。
• 版本与升级模式：读取 .story-deployed 判断是否需要从旧版本升级，并仅部署新增或变更内容，同时输出升级报告。
• 部署后验证：检查目标文件是否存在且非空，并验证 opencode.json 结构完整性，确保后续技能可直接调用。

Core Features & Use Cases

• 适用场景：
  • 你要开始第一个“网文写作项目”，希望一次性把工具链搭好并可调用子技能。
  • 你已从旧版本迁移到新版，需要升级到新的基础设施并保持原有自定义配置。
  • 你正在已有项目中补齐缺失的 Agents/Hooks/Rules/上下文模板，且希望不覆盖已有内容。

Quick Start

Ask OpenCode to run /story-setup to deploy the required Agents, Hooks, Rules, and project instruction files into your workspace.