Skip to content

rrrrrredy/research-toolkit / plugins/research-toolkit

research-toolkit

Flagged

Use for source-backed long-form research and writing in English or Chinese across fields, including revisions and continuation. Understand requirements, develop analysis through substantive research collaboration, and deliver a complete report after independent review, audit and acceptance.

FileKindSize
.codex-plugin/plugin.jsonconfig1.0 KB
.generated-files.jsonconfig6.3 KB
.mcp.jsonconfig158 B
LICENSEother1.0 KB
README.mdmarkdown3.4 KB
README.zh-CN.mdmarkdown3.0 KB
SKILL.mdskill md7.8 KB
SKILL.zh-CN.mdmarkdown6.5 KB
VERSIONother6 B
docs/compatibility.mdmarkdown3.8 KB
docs/compatibility.zh-CN.mdmarkdown3.2 KB
docs/delivery-verification.mdmarkdown19.2 KB
docs/delivery-verification.zh-CN.mdmarkdown16.3 KB
docs/review-completion.mdmarkdown18.0 KB
docs/review-completion.zh-CN.mdmarkdown14.7 KB
docs/usage-data.mdmarkdown15.4 KB
docs/usage-data.zh-CN.mdmarkdown13.9 KB
docs/usage-modes.mdmarkdown55.6 KB
docs/usage-modes.zh-CN.mdmarkdown48.6 KB
hooks/hooks.jsonconfig3.2 KB
mcp.jsonconfig253 B
plugin.jsonconfig1.1 KB
references/gotchas.mdmarkdown6.2 KB
references/gotchas.zh-CN.mdmarkdown3.6 KB
references/horizontal-vertical-analysis.mdmarkdown4.3 KB
references/horizontal-vertical-analysis.zh-CN.mdmarkdown3.2 KB
references/optional-analysis-lenses.mdmarkdown8.1 KB
references/optional-analysis-lenses.zh-CN.mdmarkdown6.1 KB
references/postmortem-lessons.mdmarkdown4.3 KB
references/postmortem-lessons.zh-CN.mdmarkdown3.5 KB
references/quality-gates.mdmarkdown5.7 KB
references/quality-gates.zh-CN.mdmarkdown4.5 KB
references/research-standard.mdmarkdown18.2 KB
references/research-standard.zh-CN.mdmarkdown13.7 KB
references/research-workflow.mdmarkdown25.5 KB
references/research-workflow.zh-CN.mdmarkdown19.9 KB
references/subagents-and-review-loop.mdmarkdown17.0 KB
references/subagents-and-review-loop.zh-CN.mdmarkdown13.4 KB
references/task-continuity.mdmarkdown6.9 KB
references/task-continuity.zh-CN.mdmarkdown5.3 KB
references/writing-style.mdmarkdown18.1 KB
references/writing-style.zh-CN.mdmarkdown14.9 KB
requirements-mcp.txtmarkdown11 B
scripts/agent_session.pyscript6.2 KB
scripts/check_delivery.pyscript44.6 KB
scripts/check_review_completion.pyscript28.5 KB
scripts/cli_agent_session.pyscript9.6 KB
scripts/codex_session.pyscript7.5 KB
scripts/extract_source_text.pyscript10.7 KB
scripts/host_review.pyscript78.4 KB
scripts/install_usage.pyscript9.7 KB
scripts/record_changes.pyscript13.7 KB
scripts/release_updates.pyscript9.8 KB
scripts/research_guidance.pyscript5.8 KB
scripts/research_host.pyscript52.4 KB
scripts/research_mcp.pyscript18.9 KB
scripts/research_records.pyscript28.5 KB
scripts/research_workflow.pyscript40.9 KB
scripts/review_process.pyscript5.2 KB
scripts/review_runner.pyscript20.2 KB
scripts/run_observation.pyscript7.7 KB
scripts/task_context.pyscript21.1 KB
scripts/task_lock.pyscript1.7 KB
scripts/task_reading.pyscript4.0 KB
scripts/task_storage.pyscript3.1 KB
scripts/usage_events.pyscript38.9 KB
scripts/usage_host.pyscript7.8 KB
scripts/usage_opencode.mjsscript3.1 KB

README.zh-CN.md

View on GitHub
# 研究工具箱插件

[English](README.md) | [简体中文](README.zh-CN.md)

一次安装,包含研究 Skill、完整方法和九个本地 MCP 工具。Agent 明确研究需求,用已有能力检索、分析与写作;需要任务管理时,包内 MCP 调用与 CLI 相同的本地能力。

使用宿主支持的插件安装方式安装解包后的[固定版本发布包](https://github.com/rrrrrredy/research-toolkit/blob/main/docs/installation-versioning.zh-CN.md#install-a-version-pinned-skill)。内置清单用 `python` 启动服务,请用宿主实际找到的 Python 3.10+ 解释器安装 MCP 依赖。若宿主无法选择该解释器,可用虚拟环境解释器的绝对路径单独接入 MCP。

重开会话,选择 Research Toolkit,确认九个 `research_*` 工具可用。提供研究问题或已有报告、来源与用途,Agent 使用完整研究方法。安装插件提供了可调用工具,不要求每份报告都创建工具管理的任务。

## 包内命令

在解压后的插件根目录运行。审计命令读取已有任务的待办审计,输出包含原意见、位置和要求的 JSON,判断与依据由 Agent 填写。配置命令显示目标路径和钩子。新安装默认关闭基础使用记录。例如任务保存在 `work/tasks/gpai`,就传 `--workspace work/tasks --task gpai`。

```sh
python scripts/research_workflow.py review --scaffold-audit --workspace WORKSPACE --task TASK_ID
python scripts/research_workflow.py setup --host codex --project . --dry-run
```

[审计与复查](docs/review-completion.zh-CN.md) · [使用记录设置](docs/usage-data.zh-CN.md) · [离线研究方法](references/research-workflow.zh-CN.md) · [评审分工](references/subagents-and-review-loop.zh-CN.md) · [接续原任务](references/task-continuity.zh-CN.md)

**[完整安装与使用说明](https://github.com/rrrrrredy/research-toolkit/blob/main/docs/usage-modes.zh-CN.md)** · [研究入口](SKILL.zh-CN.md) · [完整规范](references/research-standard.zh-CN.md)

新建工具管理任务通过独立 Agent 分组审阅、审计和判断就绪,按宿主可用名额执行。当前报告通过独立最终复查后,`finish` 记录完成,Agent 直接交付成稿。原生委派沿用宿主已有访问权限。

新安装默认关闭基础使用记录。包内宿主 hooks 仅在开启记录后采集操作。研究报告分享需要单独授权。[使用数据与控制](docs/usage-data.zh-CN.md)。

通用 `plugin.json` / `mcp.json` 与 Codex 兼容清单 `.codex-plugin/plugin.json` / `.mcp.json` 启动相同实现。MCP 通过本地 stdio 接入,不是托管的 HTTPS 服务。包内没有凭据,机械检查也不证明研究质量。

维护时先修改仓库共用源码,再运行 `python scripts/build_plugin.py` 更新包内副本;`--check` 可核对一致性。

生成归属保存在 `.generated-files.json`。`--check` 只读地检查内容与受管路径集合;构建仅删除仍与归属哈希匹配的过期副本。手写元数据与非受管内容保留,归属不明或已修改的过期副本须先核对。
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall