关于 non-fiction-revision
用于诊断非虚构类书籍修订问题的技能,适用于商业、学术、回忆录和科普作品。它区分论点、结构、证据、读者理解和来源问题,并追踪修改对全书的影响。
主要功能
- 01诊断六类修订问题
- 02评估论点、结构、证据与读者需求
- 03梳理章节和论点间的依赖关系
- 04评估修改风险与成功标准
- 05记录修改和回滚考量
适用场景
- 01找出书中论证薄弱的原因
- 02规划章节重排或核心论点修改
- 03加强证据与来源质量
- 04处理修改引发的连锁问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jwynia/ agent-skills --skill non-fiction-revision安装后在 Claude Code 中输入/non-fiction-revision确认已加载。
详细介绍
非虚构作品修订诊断
目的
诊断并指导非虚构书籍(商业、自助、学术、科普、回忆录)的修订。非虚构作品会同时涉及多个层面——论点、结构、证据、教学。一个层面的改动会连锁影响其他层面。本技能用于识别需要关注的层面,并防止修订造成损害。
快速参考
| 状态 | 信号 | 核心问题 |
|---|---|---|
| NR1 | 论点不清晰或薄弱 | 概念层面的问题 |
| NR2 | 论证缺乏逻辑递进 | 结构问题 |
| NR3 | 主张缺乏充分支撑 | 证据问题 |
| NR4 | 读者反馈称内容令人困惑 | 教学问题 |
| NR5 | 资料过时或薄弱 | 可信度问题 |
| NR6 | 修改导致新问题 | 连锁失效 |
多层结构
每本非虚构书籍都会同时涉及以下层面:
层面 1:概念/论点
- 核心论点和主要论证
- 基础假设和框架
- 哲学或理论立场
- 总体目的和预期影响
层面 2:结构/论证
- 论证的逻辑顺序和脉络
- 章节组织和依赖关系
- 证据的分布和支撑模式
- 读者的阅读历程和说服架构
层面 3:内容/证据
- 具体证据、示例和数据
- 解释和澄清
- 叙述风格、语气和易读性
- 引文、资料来源和可信度标记
层面 4:教学/读者
- 学习进程和辅助引导
- 认知负荷管理
- 参与度和记忆策略
- 实际应用指导
关键原则
一个层面的任何改动,都可能影响其他所有层面的论证有效性和读者理解。
改动会产生连锁影响:
- 向上:新证据可能削弱现有论证
- 向下:论点变更需要全面重构
- 横向:章节重新排序会影响论证的发展脉络
诊断状态
NR1:论点/核心论证问题
症状:
- 论点不清晰或没有明确陈述
- 主要论证似乎薄弱或缺乏说服力
- 核心主张经常受到质疑
- 难以阐明本书的目的
- 结论没有兑现开篇的承诺
诊断问题:
- 你能用一句话陈述论点吗?
- 支持该论点的 3-5 个主要论证是什么?
- 每个主要论证有哪些证据支持?
- 结论是否符合开篇的承诺?
- 如果论点不成立,会有哪些变化?
干预措施:
- 梳理目前所有支持该论点的证据
- 确定哪些章节依赖当前的论点表述
- 评估修订后的论点需要哪些新证据
- 检查论点变更如何影响对读者的承诺
- 评估对结论和行动号召的影响
**连锁影响警告:**论点变更最为危险——它可能使整章内容失效。更改论点前,先梳理所有依赖关系。
NR2:结构/组织问题
症状:
- 论证脉络缺乏逻辑
- 各章节似乎互不关联
- 使用前未建立必要的背景知识
- 读者必须返回前文才能理解
- 相同观点反复出现,却没有递进
诊断问题:
- 每章有哪些逻辑前提?
- 知识是在逐步累积,还是在重复?
- 是否有论证依赖后续章节的内容?
- 调整章节顺序是否会破坏逻辑?
- 过渡部分是否说明了逻辑关联?
干预措施:
- 创建章节关系依赖图
- 确定每个主要论证所需的逻辑前提
- 梳理读者知识如何随结构逐步累积
- 根据理解要求测试其他章节顺序
- 确保示例在新上下文中依然恰当
**连锁影响警告:**调整章节顺序会影响所有交叉引用以及前后文引用。请追踪所有内部引用。
NR3:证据/论证支持问题
症状:
- 主张似乎缺乏依据,或显得含糊其辞
- 只有“相信我”,没有“证据如下”
- 虽然有证据,却无法与主张关联起来
- 不同主张的论证支持质量参差不齐
- 关键论点建立在薄弱基础上
诊断问题:
- 每项主要主张由哪类证据支持?
- 全文的证据标准是否一致?
- 哪些主张的支持最薄弱?
- 证据是否真正证明了所声称的内容?
- 是否回应了反方观点?
干预措施:
- 审查每项主要主张的证据质量
- 找出需要更有力或不同类型支持的主张
- 评估新证据会如何影响现有论点
- 检查引文格式和来源质量是否一致
- 评估添加证据是否会改变论证力度
**级联警告:**为某项主张添加有力证据,可能会意外抬高读者对其他主张的证据标准,从而削弱它们。
NR4:教学/理解问题
症状:
- 读者表示感到困惑
- 复杂概念引入得太快
- 示例非但没有阐明内容,反而令人困惑
- 实际应用方式不清楚
- 目标读者无法跟上
诊断问题:
- 读者通常会在哪些地方迷失?
- 技术术语是否在使用前就已定义?
- 示例是否符合读者的经验?
- 认知负荷是分散安排还是集中在前面?
- 读者能否运用所学内容?
干预措施:
- 梳理各章节的认知负荷分布
- 找出需要更好铺垫的概念
- 评估示例的有效性和相关性
- 检查实践指导是否可操作
- 评估复杂度递进是否恰当
**级联警告:**简化内容可能会意外删去支撑论点的细微之处。应在易懂性与准确性之间取得平衡。
NR5:可信度/来源问题
症状:
- 来源似乎已经过时
- 引用方式前后不一致
- 作者的权威性受到质疑
- 示例来自不合适的时代
- 只说“据专家称”,却不指明专家
诊断问题:
- 最早的来源距今有多久?
- 来源是否适用于该领域?
- 全文的引用格式是否一致?
- 是否明确指出专家,还是泛泛而谈?
- 是否遗漏了读者预期会看到的来源?
干预措施:
- 审查来源的时效性和质量
- 找出需要更新证据支持的主张
- 统一引用格式和详略程度
- 用具体引文替换笼统的专家说法
- 补充该领域预期会引用的权威来源
**级联警告:**更新来源可能会意外改变证据实际表达的内容。请确认新来源支持相同结论。
NR6:级联失效
症状:
- 修正引发了新问题
- 某一章节的改动破坏了另一章节
- 更新证据使论证失效
- 结构调整造成了新的困惑
- 进展似乎不可能实现
诊断问题:
- 引发级联问题的最初改动是什么?
- 哪些依赖关系未被梳理?
- 是否有稳定的回滚点?
- 能够验证这一想法的最小可行改动是什么?
- 问题是局部的还是系统性的?
干预措施:
- 停止实施改动,评估影响范围
- 找出最后一个稳定状态
- 梳理实际依赖关系(而非假定的依赖关系)
- 考虑原始改动是否值得付出级联代价
- 如要继续,建立检查点机制以控制改动
回滚标准:
- 基本逻辑结构崩溃
- 证据要求变得无法满足
- 改动造成的可信度问题比解决的问题更多
- 读者理解能力受到显著影响
改动前流程
实施任何修订之前:
1. 确定改动级别
- 概念层面(论题、主要论点、框架)
- 结构层面(章节顺序、论证流程、组织方式)
- 内容层面(证据、示例、解释)
- 教学层面(呈现方式、铺垫、应用)
2. 梳理依赖关系
对于每项变更,请记录:
- 前置条件:要使此变更生效,哪些内容必须保持完整?
- 依赖项:后续哪些论点依赖此要素?
- 证据:哪些支持材料会变得必要或过时?
- 理解:这会如何影响学习过程?
3. 评估连锁风险
- 低:变更相互独立,没有依赖关系
- 中:需要更新 2-3 个其他要素
- 高:影响多个章节或核心论点
- 严重:威胁书籍的基础结构
4. 定义成功标准
变更前,先确定如何评估:
- 逻辑连贯性:论证是否仍然流畅?
- 证据充分性:论点是否仍有证据支持?
- 读者理解:读者是否仍能跟上?
- 可信度:权威性是否仍然完整?
变更记录模板
# Revision: [Brief Description]
## Change Type
- [ ] Conceptual - [ ] Structural - [ ] Content - [ ] Pedagogical
## Rationale
[Why this change improves the book]
## Dependency Analysis
- Prerequisites affected:
- Dependent elements:
- Evidence changes needed:
- Comprehension impacts:
## Cascade Risk Level
- [ ] Low - [ ] Medium - [ ] High - [ ] Critical
## Success Criteria
- Logical coherence check:
- Evidence adequacy standard:
- Reader comprehension benchmark:
## Implementation Status
- [ ] Initial change complete
- [ ] Dependencies updated
- [ ] Cross-references revised
- [ ] Cascade effects resolved
## Outcome
[Complete after implementation]
非虚构作品类型差异
学术/研究类
- 方法论一致性至关重要
- 文献综述必须保持最新
- 预先考虑同行评审的批评
- 必须清晰说明研究贡献
商业/自助类
- 实用性高于一切
- 示例必须让人觉得切合当下
- 必须提供实施指南
- ROI/效益必须清晰
科普类
- 保持易懂,但不牺牲深度
- 研究的时效性很重要
- 类比必须真正起到阐释作用
- 平衡知识传授与趣味性
回忆录/个人叙事类
- 事实准确且叙事引人入胜
- 保持情感的真实性
- 尊重隐私界限
- 将个人经历与普遍经验相联系
反模式
无休止的修订循环
修好一处,却破坏另一处,接着又破坏其他内容。书稿始终无法稳定下来。
**解决方法:**定义最小可行变更,实施变更,并在进行下一项变更前先稳定下来。
证据成瘾
不断添加更多来源,却没有提升论证质量。用数量掩盖薄弱之处。
**解决方法:**要更好的证据,而不是更多的证据。一项有力的研究胜过十项薄弱的研究。
清晰度陷阱
过度简化,导致准确性受损。读者虽然能看懂,却学到了错误的内容。
**解决方法:**逐步搭建复杂内容,而不是将其删去。循序渐进地引出细微之处。
论点漂移
小变更不断累积,最终导致书中的论点与预期不同。
**解决方法:**定期检查:结论是否仍与引言中的承诺相符?
衔接点
输入:
- 来自
research:收集新证据时 - 来自
revision:制定整体修订策略时
输出:
- 至
prose-style:结构问题解决后 - 至
fact-check:核实证据时
互补:
research:用于收集证据revision:用于修订虚构作品(并行技能)