rw-research-passport

Name: rw-research-passport
Author: rolandwonglonam

66installs16forks

How to install rw-research-passport?

rolandwonglonam/rw-research-skill/rw-research-passport

$npx -y skills add rolandwonglonam/rw-research-skill --skill rw-research-passport

Installs into the current project.

Summary

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

Files · 1

View on GitHub

SKILL.md

1	# RW Research Passport
2
3	为一个研究项目保存当前状态。Passport 是交接文件，不是文献库，也不替代原始材料。
4
5	## 启动
6
7	1. 读取 `references/method.md` 和 `references/schema.md`。
8	2. 创建新文件时复制 `assets/passport-template.json`，或运行 `scripts/passport.py init`。
9	3. 检查现有文件时运行 `scripts/passport.py validate`，再读取原始材料核对关键字段。
10	4. 需要判断边界时读取 `references/axioms.md` 和 `references/cases.md`。
11	5. 交付前读取 `references/acceptance.md`。
12
13	## 工作阶段
14
15	1. 保留用户原问题、项目范围和当前研究阶段。
16	2. 给每份材料稳定 ID，记录路径或标识符、状态和加入时间。
17	3. 分开记录判断、未知项和被否定方向，不把推断写成事实。
18	4. 交给下一个 Skill 时，只传所需材料 ID，并记录交接状态。
19	5. 每次修改追加审计记录，不覆盖变化原因。
20	6. 运行验证，输出当前状态、缺口、下一步和停止条件。
21
22	## 命令
23
24	```bash
25	python3 scripts/passport.py init project-passport.json --project-id PROJECT-ID --title "Project title"
26	python3 scripts/passport.py add-material project-passport.json --id MAT-001 --type paper --title "Paper title" --source-pointer "doi:..." --status verified
27	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
28	python3 scripts/passport.py validate project-passport.json
29	python3 scripts/passport.py summary project-passport.json
30	```
31
32	脚本只处理 JSON。原始材料可以是本地路径、DOI、PMID、URL 或其他稳定标识。
33
34	## 运行规则
35
36	- 一个 Passport 只对应一个研究项目。
37	- Passport 保存指针和状态，不复制论文全文。
38	- `verified` 只表示完成指定核验，不自动表示研究质量高。
39	- 判断必须连接材料 ID，或明确写成当前推断。
40	- 未知项不能因为流程推进而自动关闭。
41	- 交接只传当前阶段需要的材料，避免把整个工作区当作上下文。
42	- 原始材料 hash 变化后，旧材料和依赖判断不能继续作为已确认输入；按 `references/method.md` 的版本变化流程处理。
43	- 不把 Passport 当作跨项目个人记忆。
44
45	## 输出
46
47	- 可验证的 Passport JSON。
48	- 当前阶段、材料状态、已确认判断、未知项和下一步。
49	- 验证错误和不能继续的原因。
50
51	## 停止条件
52
53	- 找不到原始材料时，不把对应材料标为 `verified`。
54	- 项目 ID、材料 ID 或交接 ID 重复时，停止写入。
55	- 关键判断没有材料或推断标签时，停止交接。
56
57	## 接续
58
59	- 文献提取：`rw-paper-extractor`。
60	- 证据组织：`rw-evidence-map`。
61	- 论文写作：`rw-phd-write`。
62	- 主张核验：`rw-claim-audit`。

People who liked this also viewed

6 picks

Type

rw-research-passport

66installs16forks

View on GitHub

How to install rw-research-passport?

rolandwonglonam/rw-research-skill/rw-research-passport

$npx -y skills add rolandwonglonam/rw-research-skill --skill rw-research-passport

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# RW Research Passport
2
3	为一个研究项目保存当前状态。Passport 是交接文件，不是文献库，也不替代原始材料。
4
5	## 启动
6
7	1. 读取 `references/method.md` 和 `references/schema.md`。
8	2. 创建新文件时复制 `assets/passport-template.json`，或运行 `scripts/passport.py init`。
9	3. 检查现有文件时运行 `scripts/passport.py validate`，再读取原始材料核对关键字段。
10	4. 需要判断边界时读取 `references/axioms.md` 和 `references/cases.md`。
11	5. 交付前读取 `references/acceptance.md`。
12
13	## 工作阶段
14
15	1. 保留用户原问题、项目范围和当前研究阶段。
16	2. 给每份材料稳定 ID，记录路径或标识符、状态和加入时间。
17	3. 分开记录判断、未知项和被否定方向，不把推断写成事实。
18	4. 交给下一个 Skill 时，只传所需材料 ID，并记录交接状态。
19	5. 每次修改追加审计记录，不覆盖变化原因。
20	6. 运行验证，输出当前状态、缺口、下一步和停止条件。
21
22	## 命令
23
24	```bash
25	python3 scripts/passport.py init project-passport.json --project-id PROJECT-ID --title "Project title"
26	python3 scripts/passport.py add-material project-passport.json --id MAT-001 --type paper --title "Paper title" --source-pointer "doi:..." --status verified
27	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
28	python3 scripts/passport.py validate project-passport.json
29	python3 scripts/passport.py summary project-passport.json
30	```
31
32	脚本只处理 JSON。原始材料可以是本地路径、DOI、PMID、URL 或其他稳定标识。
33
34	## 运行规则
35
36	- 一个 Passport 只对应一个研究项目。
37	- Passport 保存指针和状态，不复制论文全文。
38	- `verified` 只表示完成指定核验，不自动表示研究质量高。
39	- 判断必须连接材料 ID，或明确写成当前推断。
40	- 未知项不能因为流程推进而自动关闭。
41	- 交接只传当前阶段需要的材料，避免把整个工作区当作上下文。
42	- 原始材料 hash 变化后，旧材料和依赖判断不能继续作为已确认输入；按 `references/method.md` 的版本变化流程处理。
43	- 不把 Passport 当作跨项目个人记忆。
44
45	## 输出
46
47	- 可验证的 Passport JSON。
48	- 当前阶段、材料状态、已确认判断、未知项和下一步。
49	- 验证错误和不能继续的原因。
50
51	## 停止条件
52
53	- 找不到原始材料时，不把对应材料标为 `verified`。
54	- 项目 ID、材料 ID 或交接 ID 重复时，停止写入。
55	- 关键判断没有材料或推断标签时，停止交接。
56
57	## 接续
58
59	- 文献提取：`rw-paper-extractor`。
60	- 证据组织：`rw-evidence-map`。
61	- 论文写作：`rw-phd-write`。
62	- 主张核验：`rw-claim-audit`。

People who liked this also viewed

6 picks

Type