用途:帮助写作者处理 Scrivener 3 项目中的命名样式(如 Heading 1、Block Quote、Code Block)与项目样式表。命名样式是集中存储、可复用的格式集合,重定义一次即可更新所有引用处,区别于一次性的直接格式化。
主要能力:区分命名样式与直接格式化,判断请求应走本技能还是 scrivener-formatting;解释样式存储模型(项目级 styles.xml、每文档 content.styles、content.rtf 中的 <$Scr_H::n> 标记);区分段落样式、字符样式与 Para+Char;说明样式在编译时可映射为标题层级或前后缀标记。
使用方式:当前可用 read 检测文档是否含样式标记:python3 ${CLAUDE_PLUGIN_ROOT}/tools/scrivener/cli.py read <id> --project "<path.scriv>" --format json,输出 constructs.styles 为 true 表示含样式跨度;配合 outline 查找文档 ID。若为 false,则文本仅经直接格式化,应改用 scrivener-formatting。
限制:style list/apply/create/redefine/remove/select/import 均为规划中,尚未在 CLI 提供,需向写作者说明可用与规划的区别。写入命令落地后需先关闭 Scrivener 并等待云同步完成,写入会自动备份与快照,样式跨度位于 content.rtf 内,编辑须保留标记,不可由纯文本重新生成富文档。标题不唯一,修改时用 UUID 定位。