rrrrrredy/research-toolkit / plugins/research-toolkit
research-toolkit
FlaggedUse 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.
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` 只读地检查内容与受管路径集合;构建仅删除仍与归属哈希匹配的过期副本。手写元数据与非受管内容保留,归属不明或已修改的过期副本须先核对。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |