关于 citation-anchoring
citation-anchoring 是一项审计技能,用于检查编辑后引用键是否仍处于原来的 Markdown 小节。它比较润色前基线与当前草稿并报告引用漂移,不会修改文本。
主要功能
- 01按小节提取引用键
- 02与已保存基线比较
- 03检测新增或移除的键
- 04识别跨小节迁移的引用
- 05生成 PASS/FAIL 报告
适用场景
- 01检查草稿润色后的引用
- 02核验主张与证据的对应关系
- 03审查有意进行的小节重组
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill citation-anchoring安装后在 Claude Code 中输入/citation-anchoring确认已加载。
详细介绍
引用锚定(回归)
触发条件与路由
- 触发词:citation anchoring、citation drift、regression、cite stability、引用锚定、引用漂移。
- 适用场景:编辑或润色后,想确认引用没有迁移到其他
###子章节。
目的:防止一种常见故障模式:润色会改写文本,并意外将引用标记移到另一个 ### 子章节,导致论点与证据不再对应。
输入
output/DRAFT.mdoutput/citation_anchors.prepolish.jsonl(基线;由draft-polisher在首次运行时创建)
输出
output/CITATION_ANCHORING_REPORT.md(PASS/FAIL + 漂移示例)
基线策略
draft-polisher每次运行时只捕获一次基线:output/citation_anchors.prepolish.jsonl。- 后续润色运行应保持每个 H3 的引用集合稳定。
工作流(仅分析)
角色:
- 审计员:仅检查并报告;不进行编辑。
步骤:
- 加载基线锚点。
- 将当前的
output/DRAFT.md解析为###子章节,并提取每个子章节的引用键。 - 将当前集合与基线集合进行比较:
- 子章节内新增或删除的键
- 在子章节之间迁移的键
- 编写
output/CITATION_ANCHORING_REPORT.md:
- 仅当未检测到漂移时,写入
- Status: PASS - 否则,写入
- Status: FAIL,并附上简短的差异表和示例
注意事项
如果你有意在子章节之间调整结构:
- 删除
output/citation_anchors.prepolish.jsonl并重新生成基线(之后将其作为新的回归锚点)。
故障排除
问题:缺少基线锚点文件
修复方法:
- 运行一次
draft-polisher以生成output/citation_anchors.prepolish.jsonl,然后重新运行锚定检查。
问题:有意在子章节之间移动了引用
修复方法:
- 删除
output/citation_anchors.prepolish.jsonl并重新生成基线(之后将其作为新的回归锚点)。
评论
支持 Markdown