rw-research-passport

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

RW Research Passport

为一个研究项目保存当前状态。Passport 是交接文件，不是文献库，也不替代原始材料。

Save the current status for a research project. The Passport is a handover document, not a literature library, nor a replacement for original materials.

启动

Initiation

读取

references/method.md

和

references/schema.md

。

创建新文件时复制

assets/passport-template.json

，或运行

scripts/passport.py init

。

检查现有文件时运行
```
scripts/passport.py validate
```
，再读取原始材料核对关键字段。
需要判断边界时读取
```
references/axioms.md
```
和
```
references/cases.md
```
。
交付前读取
```
references/acceptance.md
```
。

Read

references/method.md

and

references/schema.md

Copy

assets/passport-template.json

when creating a new file, or run

scripts/passport.py init

Run
```
scripts/passport.py validate
```
when checking existing files, then read the original materials to verify key fields.
Read
```
references/axioms.md
```
and
```
references/cases.md
```
when boundary judgments are needed.
Read
```
references/acceptance.md
```
before delivery.

工作阶段

Work Phases

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

Keep the user's original question, project scope, and current research phase.
Assign a stable ID to each material, record its path or identifier, status, and addition time.
Record judgments, unknowns, and rejected directions separately; do not present inferences as facts.
When handing over to the next Skill, only pass the required material IDs and record the handover status.
Append audit records for each modification; do not overwrite the reasons for changes.
Run validation and output the current status, gaps, next steps, and stop conditions.

命令

Commands

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 validate project-passport.json
python3 scripts/passport.py summary project-passport.json

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

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 validate project-passport.json
python3 scripts/passport.py summary project-passport.json

The script only processes JSON. Original materials can be local paths, DOIs, PMIDs, URLs, or other stable identifiers.

运行规则

Operating Rules

一个 Passport 只对应一个研究项目。
Passport 保存指针和状态，不复制论文全文。
```
verified
```
只表示完成指定核验，不自动表示研究质量高。
判断必须连接材料 ID，或明确写成当前推断。
未知项不能因为流程推进而自动关闭。
交接只传当前阶段需要的材料，避免把整个工作区当作上下文。
原始材料 hash 变化后，旧材料和依赖判断不能继续作为已确认输入；按
```
references/method.md
```
的版本变化流程处理。
不把 Passport 当作跨项目个人记忆。

One Passport corresponds to only one research project.
The Passport stores pointers and status, not full copies of papers.
```
verified
```
only indicates that the specified verification is completed, not automatically that the research quality is high.
Judgments must be linked to material IDs or clearly marked as current inferences.
Unknowns cannot be automatically closed due to process advancement.
Only pass materials required for the current phase during handover; avoid treating the entire workspace as context.
After the hash of original materials changes, old materials and dependent judgments can no longer be used as confirmed inputs; follow the version change process in
```
references/method.md
```
.
Do not use the Passport as cross-project personal memory.

输出

Outputs

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

Verifiable Passport JSON.
Current phase, material status, confirmed judgments, unknowns, and next steps.
Validation errors and reasons for inability to proceed.

停止条件

Stop Conditions

找不到原始材料时，不把对应材料标为
```
verified
```
。
项目 ID、材料 ID 或交接 ID 重复时，停止写入。
关键判断没有材料或推断标签时，停止交接。

Do not mark the corresponding material as
```
verified
```
when the original material cannot be found.
Stop writing when project ID, material ID, or handover ID is duplicated.
Stop handover when key judgments have no material or inference tags.

接续

Follow-up Tasks

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

Literature extraction:
```
rw-paper-extractor
```
.
Evidence organization:
```
rw-evidence-map
```
.
Paper writing:
```
rw-phd-write
```
.
Claim verification:
```
rw-claim-audit
```
.