Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Other skills

webnovel-learn

从当前会话提取成功模式并写入 project_memory.json

lujih · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add lujih/webnovel-writer-opencode --skill webnovel-learn

About this skill


name: webnovel-learn description: 从当前会话提取成功模式并写入 project_memory.json compatibility: opencode

/webnovel-learn

Project Root Guard(必须先确认)

  • 必须在项目根目录执行(需存在 .webnovel/state.json)
  • 使用统一入口解析项目根,避免写错目录:
export WORKSPACE_ROOT="${PWD}"
export SCRIPTS_DIR="${PWD}/.opencode/scripts"
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
test -n "$PROJECT_ROOT" && test -f "${PROJECT_ROOT}/.webnovel/state.json" || { echo "❌ PROJECT_ROOT 解析失败"; exit 1; }

目标

  • 提取可复用的写作模式(钩子/节奏/对话/微兑现等)
  • 追加到 .webnovel/project_memory.json

执行流程

  1. 读取 "$PROJECT_ROOT/.webnovel/state.json",获取当前章节号(progress.current_chapter)
  2. 解析用户输入,归类 pattern_type(hook/pacing/dialogue/payoff/emotion/format/other)
  3. 必须调用脚本写入,不得手写或拼接 JSON:
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" project-memory add-pattern \
  --pattern-type "{pattern_type}" \
  --description "{用户输入或提炼后的完整描述}" \
  --category "{分类,可空}" \
  --importance "{high|medium|low}"

脚本会自动读取/初始化 .webnovel/project_memory.json,并用 JSON 序列化写回,自动转义英文双引号、换行等字符。

约束

  • 不删除旧记录,仅追加
  • 追加前扫描已有 patterns,pattern_type + description 完全相同则跳过
  • 禁止使用 Write 或手工编辑 .webnovel/project_memory.json

成功标准

  • project_memory.json 存在且格式合法
  • 新 pattern 已追加到 patterns 数组
  • 输出包含 status: success 和完整 learned 对象

失败恢复

故障恢复方式
project_memory.json 不存在自动初始化 {"patterns": []} 后继续
JSON 解析失败不写入脏数据,告知用户文件损坏并建议手动修复
state.json 缺失导致无法获取章节号使用 source_chapter: null,不阻断
用户输入无法归类使用 pattern_type: "other",不阻断