verification
Agent skill fromNorman-bury/research-writing-skill
Use when about to claim work is complete, a chapter is finished, or references are verified - requires running verification commands and confirming output before making any success claims
How to install verification
install verification
# install the research-writing-skill pack with the skills CLI
npx skills add Norman-bury/research-writing-skill# or add only this skill to Claude Code: copy the folder
skills/verification/
# into
~/.claude/skills/verification/ (all projects)
.claude/skills/verification/ (one project)
1# 验证机制23## 核心原则45**声称完成而没有验证,是不诚实的表现。**67```8没有验证证据,就不能声称完成9```1011## 验证门控1213```14在声称任何状态或表达满意之前:15161. 确认:什么命令/操作能证明这个声称?172. 执行:运行完整的验证操作183. 读取:完整输出,检查结果194. 验证:输出是否确认声称?20 - 如果否:说明实际状态和证据21 - 如果是:说明声称和证据225. 然后才能:做出声称2324跳过任何步骤 = 撒谎,不是验证25```2627## 常见验证场景2829| 声称 | 需要的验证 | 不充分 |30|------|----------|--------|31| 章节完成 | 字数统计、结构检查、文件存在 | "应该写完了" |32| 引用真实 | DOI 可访问、CrossRef API 确认 | "看起来像真的" |33| 论点有支撑 | evidence map 中有段落级证据 | "这段写得像论文" |34| 格式正确 | 运行格式检查脚本 | 目测检查 |35| 无AI痕迹 | 运行风格检查脚本 | "读起来还行" |36| 文献搜索完成 | 结果数量、DOI 列表、JSON 文件存在 | "搜过了" |37| skill 改造完成 | 运行 `scripts/check_skill_integrity.ps1` | "文件都写了" |38| 初稿达到质量门 | 运行 `scripts/research_quality_gate.ps1` | 只运行 style_check |3940## Red Flags - 停止4142出现以下情况时,必须先验证:4344- 使用"应该"、"可能"、"看起来"45- 在验证前表达满意("好了!"、"完成!")46- 准备提交/推送/合并而不验证47- 相信代理的成功报告48- 依赖部分验证49- 想着"就这一次"50- 疲劳想结束工作51- **任何暗示成功但没有运行验证的措辞**5253## 借口与事实5455| 借口 | 事实 |56|------|------|57| "应该行了" | 运行验证命令 |58| "我很确信" | 确信 ≠ 证据 |59| "就这一次" | 没有例外 |60| "格式检查过了" | 格式检查 ≠ 内容正确 |61| "代理说成功了" | 独立验证 |62| "我累了" | 疲劳不是借口 |63| "部分检查够了" | 部分证明不了什么 |6465## 关键验证模式6667### 章节完成验证6869```70✅ [运行字数统计] [看到:3000字] "章节字数达标"71✅ [检查文件存在] [看到:chapters/01-introduction.md 存在] "章节文件已创建"72✅ [运行格式检查] [看到:0 errors] "格式正确"73❌ "应该写完了" / "看起来完整"74```7576### 引用验证7778```79✅ [调用 CrossRef API] [看到:DOI 存在,信息匹配] "引用已验证"80✅ [搜索原始来源] [找到:作者、期刊、年份一致] "引用真实"81❌ "引用看起来正确" / "应该是真的"82```8384### 论点支撑验证8586```87✅ [检查 evidence-map] [看到:每个 gap claim 对应 2 条来源] "研究空白有文献支撑"88✅ [检查 citation slot] [看到:段落 P2 使用 FL-05 + FL-07] "引用位置明确"89❌ "相关工作看起来完整" / "这段有学术感"90```9192### Skill 完整性验证9394```powershell95…
Excerpt shown under the repository's MIT license.
