使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/lingfengqaq/webnovel-writer --skill webnovel-learn开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
/webnovel-learn
Project Root Guard（必须先确认）
- 必须在项目根目录执行（需存在
.webnovel/state.json） - 用统一入口解析项目根，避免写错目录：
bash
export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:?}/scripts"
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"目标
提取可复用的写作模式（钩子/节奏/对话/微兑现等），追加到 .webnovel/project_memory.json。
执行流程
- 读取
"$PROJECT_ROOT/.webnovel/state.json"的progress.current_chapter作为当前章节号；缺失则用source_chapter: null，不阻断。 - 解析用户输入（
/webnovel-learn后的经验文本；为空则取本次对话中用户认可的写法），归类pattern_type（hook/pacing/dialogue/payoff/emotion/format/other，无法归类用other）。 - 调用
project-memory add-pattern写入，不得手写或拼接 JSON：
bash
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}"约束
- 不删除旧记录，仅追加。
- 追加前扫描已有
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，不阻断 |
