# Rw Research Passport

> 为单个研究项目建立和维护可审计的 JSON 状态文件，记录研究阶段、材料、判断、Research Credential、未知项、交接和变更日志。Use when the user asks for“建立研究档案”“保存这个研究项目的材料状态”“记录会议或讨论定下来的事项”“给研究决定生成凭据”“把文献、判断和下一步交给另一个科研 Skill”“检查研究状态文件”,or requests the rw-research-passport workflow.

- Skill: `ozrwayne/rw-research-passport` (Agent Skill, multi-file: 15 files)
- Install (CLI): `npx skillmds@latest add ozrwayne/rw-research-passport`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ozrwayne/rw-research-passport/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: ozrwayne (https://skillmd.com/u/ozrwayne)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ozrwayne/rw-research-passport

---


# RW Research Passport

为一个研究项目保存当前状态。Passport 是交接文件，不是文献库，也不替代原始材料。Research Credential 记录一次会议、头脑风暴或人机讨论形成决定时的内容、参与者、权限、适用范围和原始记录位置。

## 启动

1. 读取 `references/method.md` 和 `references/schema.md`。
2. 创建新文件时复制 `assets/passport-template.json`，或运行 `scripts/passport.py init`。
3. 检查现有文件时运行 `scripts/passport.py validate`，再读取原始材料核对关键字段。
4. 需要判断边界时读取 `references/axioms.md` 和 `references/cases.md`。
5. 交付前读取 `references/acceptance.md`。

## 工作阶段

1. 保留用户原问题、项目范围和当前研究阶段。
2. 给每份材料稳定 ID，记录路径或标识符、状态和加入时间。
3. 分开记录判断、未知项和被否定方向，不把推断写成事实。
4. 交给下一个 Skill 时，只传所需材料 ID，并记录交接状态。
5. 每次修改追加审计记录，不覆盖变化原因。
6. 讨论形成决定时，为决定生成 Research Credential；没有形成决定时只记录未知项或讨论材料。
7. 运行验证，输出当前状态、缺口、下一步和停止条件。

## 命令

```bash
python3 scripts/passport.py init project-passport.json --project-id PROJECT-ID --title "Project title"
python3 scripts/passport.py add-material project-passport.json --id MAT-001 --type paper --title "Paper title" --source-pointer "doi:..." --status verified
python3 scripts/passport.py add-material project-passport.json --id MAT-002 --type paper --title "Updated paper" --source-pointer "path-or-id" --content-sha256 SHA256 --supersedes-id MAT-001
python3 scripts/passport.py record-credential project-passport.json --credential-id RCRED-001 --decision-id DEC-001 --statement "Confirmed research decision" --status confirmed --session-id SESSION-001 --record-pointer "notes:SESSION-001" --settled-by human:HUMAN-ID --authority human_confirmed --basis reasoning --scope "PROJECT-ID"
python3 scripts/passport.py validate project-passport.json
python3 scripts/passport.py summary project-passport.json
```

脚本只处理 JSON。原始材料可以是本地路径、DOI、PMID、URL 或其他稳定标识。

## 运行规则

- 一个 Passport 只对应一个研究项目。
- Passport 保存指针和状态，不复制论文全文。
- `verified` 只表示完成指定核验，不自动表示研究质量高。
- 判断必须说明依据。`evidence` 连接材料 ID；`reasoning` 记录讨论推理；`delegated_choice` 记录已委托范围内的选择。
- 一个已定事项对应一个 Decision 和一个 Research Credential，不把多个决定合成一条凭据。
- `settled_by` 记录参与确认的人或 Agent；`authority` 记录本次决定来自建议、Agent 共识、已委托权限或人类确认；`basis` 记录证据、推理或已委托选择。
- Agent 共识不自动等于人类确认。下游 Skill 按任务需要检查 `authority`。
- Credential 保存讨论记录指针和决定快照，不复制会议全文或聊天全文。
- Credential 写入后不改写。决定变化时创建新 Credential，并用 `supersedes` 指向旧 Credential。
- `content_hash` 只检查 Credential 内容是否变化，不证明研究决定正确。
- 未知项不能因为流程推进而自动关闭。
- 交接只传当前阶段需要的材料，避免把整个工作区当作上下文。
- 原始材料 hash 变化后，旧材料和依赖判断不能继续作为已确认输入；按 `references/method.md` 的版本变化流程处理。
- 不把 Passport 当作跨项目个人记忆。

## 输出

- 可验证的 Passport JSON 和 Research Credential。
- 当前阶段、材料状态、已确认判断、未知项和下一步。
- 验证错误和不能继续的原因。

## 可选 ADHD 友好输出

- 仅当用户明确要求“ADHD 友好输出”“ADHD 友好模式”或同义方式时启用。
- 不主动询问、介绍或推荐这个模式，不根据表达方式、回复速度或任务完成情况推断。
- 用户只披露有 ADHD，但没有要求改变输出方式时，不启用。
- 默认只在当前任务中保持；用户要求关闭时立即返回普通输出。
- 不保存诊断信息。用户明确要求跨任务保留时，只保存 `interaction_mode: adhd_friendly`。
- 启用后先给“只看这里”：当前任务、用户现在只做的 1 件事和本轮完成标准。
- 多步骤任务再给进度：已完成、当前和待处理；简单回答不生成空栏目。
- 重要但不需要现在处理的内容进入“暂存区”；详细证据放在摘要之后。
- 每轮最多提出 1 个关键问题；必须输入先展示最多 3 项，其余放到后续。
- 加粗当前任务、用户动作、结论和阻断状态；每段不超过 2 处，不加粗整段，不重复加粗同一词。
- 不为缩短输出删除证据边界、未知事项、停止条件或安全提示。
- 用户要求“展开”时提供完整记录，同时保留顶部摘要。
- 中断后先给恢复点，说明上次完成位置、当前状态和下一步，不要求用户重复已提供的信息。

## 停止条件

- 找不到原始材料时，不把对应材料标为 `verified`。
- 项目 ID、材料 ID 或交接 ID 重复时，停止写入。
- 关键判断没有材料或推断标签时，停止交接。
- 已定事项缺少讨论记录指针、确认者、权限范围或 Credential 时，停止交接。

## 接续

- 文献提取：`rw-paper-extractor`。
- 证据组织：`rw-evidence-map`。
- 论文写作：`rw-phd-write`。
- 主张核验：`rw-claim-audit`。