行业研究引擎

把行业、赛道和公司问题变成可复核研究报告

行业研究引擎是一套 Go CLI + 智能体技能。它把模糊的行业研究、赛道分析、公司研究和商业机会判断，转成可复核的研究工作区和结构化报告。

底层 researcher 是 Go 写的研究引擎，负责生成命题图、痕迹计划、证据台账、反证记录、置信度报告和最终报告。上层 SKILL.md 是智能体技能，负责把研究流程编排给 Claude Code、OpenClaw、hermes-agent 等支持技能式工作流的 Agent 框架。

它的核心原则很简单：搜索结果只是线索，不是证据。高置信度结论必须经过来源核验、经营痕迹验证、交叉比对和反证尝试。

输入：瑞幸咖啡 2026 年门店数目标是否可信？
输出：可复核工作区、证据台账、反证记录、置信度报告和最终调研报告

1. 输入行业、赛道、公司或商业机会问题。
2. 把问题拆成可验证命题，并规划现实世界应留下的痕迹。
3. 收集网页、公告、招聘、地图、经营系统和模型联网回答等线索。
4. 用证据台账、反证记录和多角色审查降低误判。
5. 输出带置信度边界的研究报告。

推荐用 skills 直接安装智能体技能：

npx skills add geekjourneyx/industry-research

仓库地址：geekjourneyx/industry-research

如果你需要本地开发、调试或单独使用底层研究引擎，再克隆仓库并构建：

git clone git@github.com:geekjourneyx/industry-research.git
cd industry-research/researcher
make build

检查可执行文件：

./researcher version
./researcher capabilities --json

更多命令、配置和检索服务说明见 researcher 使用说明。

可选的检索服务密钥：

export BOCHA_API_KEY="..."
export ARK_API_KEY="..."

配置读取顺序如下：

--config <path>
RESEARCHER_CONFIG
$XDG_CONFIG_HOME/researcher/config.yaml
~/.config/researcher/config.yaml

安装 Skill 后，在支持技能式工作流的智能体框架里发起行业研究请求即可。 如果只想使用底层研究引擎，可以直接阅读 researcher 使用说明。

生成一份连锁品牌研究工作区：

cd researcher

./researcher run "瑞幸咖啡 2026 年门店数目标是否可信？" \
  --domain chain-brand \
  --depth standard \
  --workspace-root ../industry-research-workspace \
  --json

校验生成的工作区：

./researcher validate ../industry-research-workspace/<workspace>

python3 ../scripts/validate_report.py \
  --researcher-workspace ../industry-research-workspace/<workspace>

运行本地检查：

make fmt
make vet
make test
make build

每次执行 researcher run 都会生成以下工作区文件：

餐饮、零售、供应链和连锁品牌研究中，最关键的质量文件是 trace_plan.json、evidence_ledger.json、disconfirmation_log.json 和 confidence_report.json。

系统会把弱研究报告里经常混在一起的四层内容拆开：

对于毛利、单店模型、产能利用率、SKU 动销、履约成本、留存率等隐藏经营变量，报告必须区分公开披露事实和推理区间，并写明还缺哪些一手数据。

researcher 通过 GitHub Actions 从版本 tag 发布。每次发布前必须完成文档校准、CHANGELOG.md 更新、Go 检查、二进制编译和校验文件生成。

发布步骤：

cd researcher
make fmt
make vet
make test
make build

cd ..
RELEASE_TAG=v$(tr -d '[:space:]' < researcher/VERSION) researcher/scripts/check-release.sh
git tag v$(tr -d '[:space:]' < researcher/VERSION)
git push origin v$(tr -d '[:space:]' < researcher/VERSION)

推送 v*.*.* tag 后，GitHub Actions 会编译 macOS、Linux、Windows 的 amd64/arm64 版本，生成压缩包和 SHA256 校验文件，并创建 GitHub Release。

一句话描述：

行业研究引擎是一个 Go CLI + 智能体技能，用于把行业、赛道和公司问题转成可复核的研究工作区、证据台账、置信度报告和最终研究报告。

GitHub Description 建议：

Go CLI + Agent Skill for evidence-based industry research, evidence ledgers, confidence reports, and agent research workflows

Topics 建议：

agent-skill  industry-research  market-research  go  cli
evidence-ledger  research-automation  competitive-intelligence
chain-brand  supply-chain

MIT — 自由使用、修改、分发。