novel-weaver — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited novel-weaver (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
本文档由 skill-standardization 自动化审计与维护。
novel_state.json 的 pipeline 字段。set-phase 在 phase 转换前检查前置门禁,未通过则阻断。novel_pipeline_gate.py status 查看状态plan-chapter(含情绪 tone)→ verify-causality-sub(因果链验证)→ context_loader 通过子结构存在性检查,才可开始写作L##S## 标记行(会被阻断)novel_state_manager.py add-char,每章结束时 novel_timeline.py addnovel_workflow_engine.py finalize-chapter 推进 phasenovel_fidelity.py(大纲忠实度)+ set-phase stage3_readyset-phase 在 →writing(检查 outline_causality 门禁)和 →stage3_ready(检查 fidelity 门禁)时自动调用 novel_pipeline_gate.py require 阻断正向触发:
否定条件:
📚 渐进式加载:本技能采用渐进式 MD 体系,SKILL.md为入口(≤230行),详细内容拆分到references/*.md按需加载。
本技能采用渐进式 MD 体系,SKILL.md 为入口(≤230行),详细内容拆分到 references/。
| 文件 | 内容 |
|---|---|
| references/execution_standards.md | 字数管理 / 文体规范 / novel_state.json 结构 / 子结构文件格式 / 章节输出 / 时间线 / 角色表 / 结尾收束 |
| references/hooks.md | 16 个流程钩子 + 门禁系统一览(类型/行为/脚本) |
| references/antipatterns.md | 常见反模式与正确做法 |
| references/faq.md | 常见问题与排除 |
| references/changelog.md | 版本更新日志 |
| references/examples.md | 使用示例 |
| references/permissions.md | 权限说明 |
| references/LICENSE.md | MIT 许可证 |
| 文件名 | 分类 | 包含内容 | 审计关联 |
|---|---|---|---|
references/LICENSE.md | 许可协议 | 开源许可证声明(MIT)。包含:MIT 许可证完整文本。 | R-26 |
references/antipatterns.md | 规范指南 | skill 编写中的常见反模式。包含:错误做法示例、正确做法示例、避坑指引。 | R-18 |
references/changelog.md | 版本管理 | 版本更新日志。包含:版本号、变更类型、修复项、升级说明。 | R-24 |
references/examples.md | 使用示例 | 各场景完整执行示例。包含:CLI 命令、执行过程、输出结果。 | R-25 C-17 |
references/execution_standards.md | 参考文档 | / 层级 / 上限 / 说明 / | 无 |
references/faq.md | 常见问题 | 常见疑问与解答。包含:问题分类、原因分析、解决方案。 | R-19, R-25 C-19 |
references/hooks.md | 参考文档 | 每个钩子成功完成后自动调用 pipeline_gate.py pass 更新全局状态。set-phase 在 phase 转换前自动调用 `pipeli | 无 |
references/permissions.md | 权限与测试 | 权限扫描说明与测试结论。包含:风险等级、高权限操作说明、测试概览、计时统计。 | R-15, R-16 |
| 维度 | 说明 |
|---|---|
| 适用场景 | 长篇小说/故事的结构化写作(8000字+),含三阶段流水线和质量控制 |
| 不适用场景 | 短文/散文/诗歌/新闻稿;改写/润色/翻译 — 不是本技能范围 |
| 输入要求 | 用户至少提供一个模糊的故事想法或主题方向。支持续写(已有 novel_state.json) |
| 输出格式 | 纯文本书写文件(.txt)+ 结构化元数据(novel_state.json)+ Markdown 报告 |
| 依赖环境 | Python 3.8+,标准库(json/os/sys/re/subprocess),无外部包依赖 |
| 离线可用 | 完全离线,本地运行,无网络请求 |
| 参数约束 | 子结构 1-99(S01~S99),每段 ≤200 行;章节 1-15(L01~L15),每章 3-5 个子结构 |
| 数据安全 | 数据存储在项目目录内,无外部传输。pipeline 门禁状态记录到 novel_state.json |
输入:用户模糊的想法
novel_workflow_engine.py verify-causality-outline <state_path>逐链节检查 L01→L02→…L15 的因果递进。每节的概述必须显式承载"上一章的果 → 下一章的因"。全部 PASS 后才可进入下一步。
输入:当前一级标题 + 模糊概述
a. LLM生成子结构细化(S01-S05 编号 + 标题 + 模糊概述 + 情绪提示 tone) b. 展示给用户(可选确认) c. 调用 novel_workflow_engine.py plan-chapter 批量注册所有子结构到 novel_state.json d. 因果链验证
novel_workflow_engine.py verify-causality-sub <state_path> <L##>逐链节检查 S01→S02→… 的因果递进,全部 PASS 后才可开始写作。 e. 验证:novel_workflow_engine.py verify-chapter 检查全部注册 f. phase 推进:若通过 outline_causality 门禁检查,自动推进到 writing
a. 调用 novel_context_loader.py 加载上下文(无子结构 → 报错阻断)
b. 用 novel_atomic_writer.py tail 读上一个子结构的末3行(跳过编号标记)作为连接锚点 c. 写作 ≤200 行,自然段落结束 d. 用 novel_atomic_writer.py 写入(正文含标记行 L##S## → 报错阻断) e. 用 novel_state_manager.py update-sub 更新字数 / 状态
中断恢复:无论中断发生在子结构开始前还是写作中,下次进入时必须重新调用 context_loader 获取命题指令 + 已写内容锚点,确保文风/人物/时间线一致
a. 连通性补充(novel_continuity.py + auto-fix) b. 风格校验(novel_style_check.py) c. 逻辑检查(novel_logic_check.py — 人物行为一致性 / 时间线逻辑 / 内容-概述匹配度)
阶段3:全文整合
输入:全部章节完成
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.