Tooluck logoTooluck
SKILL.md

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)

skills/verification/SKILL.md

MITFull file
1# 验证机制
2
3## 核心原则
4
5**声称完成而没有验证,是不诚实的表现。**
6
7```
8没有验证证据,就不能声称完成
9```
10
11## 验证门控
12
13```
14在声称任何状态或表达满意之前:
15
161. 确认:什么命令/操作能证明这个声称?
172. 执行:运行完整的验证操作
183. 读取:完整输出,检查结果
194. 验证:输出是否确认声称?
20 - 如果否:说明实际状态和证据
21 - 如果是:说明声称和证据
225. 然后才能:做出声称
23
24跳过任何步骤 = 撒谎,不是验证
25```
26
27## 常见验证场景
28
29| 声称 | 需要的验证 | 不充分 |
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 |
39
40## Red Flags - 停止
41
42出现以下情况时,必须先验证:
43
44- 使用"应该"、"可能"、"看起来"
45- 在验证前表达满意("好了!"、"完成!")
46- 准备提交/推送/合并而不验证
47- 相信代理的成功报告
48- 依赖部分验证
49- 想着"就这一次"
50- 疲劳想结束工作
51- **任何暗示成功但没有运行验证的措辞**
52
53## 借口与事实
54
55| 借口 | 事实 |
56|------|------|
57| "应该行了" | 运行验证命令 |
58| "我很确信" | 确信 ≠ 证据 |
59| "就这一次" | 没有例外 |
60| "格式检查过了" | 格式检查 ≠ 内容正确 |
61| "代理说成功了" | 独立验证 |
62| "我累了" | 疲劳不是借口 |
63| "部分检查够了" | 部分证明不了什么 |
64
65## 关键验证模式
66
67### 章节完成验证
68
69```
70✅ [运行字数统计] [看到:3000字] "章节字数达标"
71✅ [检查文件存在] [看到:chapters/01-introduction.md 存在] "章节文件已创建"
72✅ [运行格式检查] [看到:0 errors] "格式正确"
73❌ "应该写完了" / "看起来完整"
74```
75
76### 引用验证
77
78```
79✅ [调用 CrossRef API] [看到:DOI 存在,信息匹配] "引用已验证"
80✅ [搜索原始来源] [找到:作者、期刊、年份一致] "引用真实"
81❌ "引用看起来正确" / "应该是真的"
82```
83
84### 论点支撑验证
85
86```
87✅ [检查 evidence-map] [看到:每个 gap claim 对应 2 条来源] "研究空白有文献支撑"
88✅ [检查 citation slot] [看到:段落 P2 使用 FL-05 + FL-07] "引用位置明确"
89❌ "相关工作看起来完整" / "这段有学术感"
90```
91
92### Skill 完整性验证
93
94```powershell
95…

Excerpt shown under the repository's MIT license.

More skills in research-writing-skill

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates