mcpField
N
non-fiction-revision

non-fiction-revision

github.com/jwynia创意与媒体179326 次安装35 周前更新
代码仓库

关于 non-fiction-revision

用于诊断非虚构类书籍修订问题的技能,适用于商业、学术、回忆录和科普作品。它区分论点、结构、证据、读者理解和来源问题,并追踪修改对全书的影响。

主要功能

  1. 01诊断六类修订问题
  2. 02评估论点、结构、证据与读者需求
  3. 03梳理章节和论点间的依赖关系
  4. 04评估修改风险与成功标准
  5. 05记录修改和回滚考量

适用场景

  1. 01找出书中论证薄弱的原因
  2. 02规划章节重排或核心论点修改
  3. 03加强证据与来源质量
  4. 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:论点/核心论证问题

症状:

  • 论点不清晰或没有明确陈述
  • 主要论证似乎薄弱或缺乏说服力
  • 核心主张经常受到质疑
  • 难以阐明本书的目的
  • 结论没有兑现开篇的承诺

诊断问题:

  1. 你能用一句话陈述论点吗?
  2. 支持该论点的 3-5 个主要论证是什么?
  3. 每个主要论证有哪些证据支持?
  4. 结论是否符合开篇的承诺?
  5. 如果论点不成立,会有哪些变化?

干预措施:

  1. 梳理目前所有支持该论点的证据
  2. 确定哪些章节依赖当前的论点表述
  3. 评估修订后的论点需要哪些新证据
  4. 检查论点变更如何影响对读者的承诺
  5. 评估对结论和行动号召的影响

**连锁影响警告:**论点变更最为危险——它可能使整章内容失效。更改论点前,先梳理所有依赖关系。


NR2:结构/组织问题

症状:

  • 论证脉络缺乏逻辑
  • 各章节似乎互不关联
  • 使用前未建立必要的背景知识
  • 读者必须返回前文才能理解
  • 相同观点反复出现,却没有递进

诊断问题:

  1. 每章有哪些逻辑前提?
  2. 知识是在逐步累积,还是在重复?
  3. 是否有论证依赖后续章节的内容?
  4. 调整章节顺序是否会破坏逻辑?
  5. 过渡部分是否说明了逻辑关联?

干预措施:

  1. 创建章节关系依赖图
  2. 确定每个主要论证所需的逻辑前提
  3. 梳理读者知识如何随结构逐步累积
  4. 根据理解要求测试其他章节顺序
  5. 确保示例在新上下文中依然恰当

**连锁影响警告:**调整章节顺序会影响所有交叉引用以及前后文引用。请追踪所有内部引用。

NR3:证据/论证支持问题

症状:

  • 主张似乎缺乏依据,或显得含糊其辞
  • 只有“相信我”,没有“证据如下”
  • 虽然有证据,却无法与主张关联起来
  • 不同主张的论证支持质量参差不齐
  • 关键论点建立在薄弱基础上

诊断问题:

  1. 每项主要主张由哪类证据支持?
  2. 全文的证据标准是否一致?
  3. 哪些主张的支持最薄弱?
  4. 证据是否真正证明了所声称的内容?
  5. 是否回应了反方观点?

干预措施:

  1. 审查每项主要主张的证据质量
  2. 找出需要更有力或不同类型支持的主张
  3. 评估新证据会如何影响现有论点
  4. 检查引文格式和来源质量是否一致
  5. 评估添加证据是否会改变论证力度

**级联警告:**为某项主张添加有力证据,可能会意外抬高读者对其他主张的证据标准,从而削弱它们。


NR4:教学/理解问题

症状:

  • 读者表示感到困惑
  • 复杂概念引入得太快
  • 示例非但没有阐明内容,反而令人困惑
  • 实际应用方式不清楚
  • 目标读者无法跟上

诊断问题:

  1. 读者通常会在哪些地方迷失?
  2. 技术术语是否在使用前就已定义?
  3. 示例是否符合读者的经验?
  4. 认知负荷是分散安排还是集中在前面?
  5. 读者能否运用所学内容?

干预措施:

  1. 梳理各章节的认知负荷分布
  2. 找出需要更好铺垫的概念
  3. 评估示例的有效性和相关性
  4. 检查实践指导是否可操作
  5. 评估复杂度递进是否恰当

**级联警告:**简化内容可能会意外删去支撑论点的细微之处。应在易懂性与准确性之间取得平衡。


NR5:可信度/来源问题

症状:

  • 来源似乎已经过时
  • 引用方式前后不一致
  • 作者的权威性受到质疑
  • 示例来自不合适的时代
  • 只说“据专家称”,却不指明专家

诊断问题:

  1. 最早的来源距今有多久?
  2. 来源是否适用于该领域?
  3. 全文的引用格式是否一致?
  4. 是否明确指出专家,还是泛泛而谈?
  5. 是否遗漏了读者预期会看到的来源?

干预措施:

  1. 审查来源的时效性和质量
  2. 找出需要更新证据支持的主张
  3. 统一引用格式和详略程度
  4. 用具体引文替换笼统的专家说法
  5. 补充该领域预期会引用的权威来源

**级联警告:**更新来源可能会意外改变证据实际表达的内容。请确认新来源支持相同结论。


NR6:级联失效

症状:

  • 修正引发了新问题
  • 某一章节的改动破坏了另一章节
  • 更新证据使论证失效
  • 结构调整造成了新的困惑
  • 进展似乎不可能实现

诊断问题:

  1. 引发级联问题的最初改动是什么?
  2. 哪些依赖关系未被梳理?
  3. 是否有稳定的回滚点?
  4. 能够验证这一想法的最小可行改动是什么?
  5. 问题是局部的还是系统性的?

干预措施:

  1. 停止实施改动,评估影响范围
  2. 找出最后一个稳定状态
  3. 梳理实际依赖关系(而非假定的依赖关系)
  4. 考虑原始改动是否值得付出级联代价
  5. 如要继续,建立检查点机制以控制改动

回滚标准:

  • 基本逻辑结构崩溃
  • 证据要求变得无法满足
  • 改动造成的可信度问题比解决的问题更多
  • 读者理解能力受到显著影响

改动前流程

实施任何修订之前:

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:用于修订虚构作品(并行技能)

评论

支持 Markdown