GitLink Research Insight Agent

面向 CCF GitLink 智能化服务开源项目贡献赛子赛题四“应用 GitLink 辅助科研”的科研仓库智能洞察与验证工作流。

本项目基于 gitlink-cli、GitLink OpenAPI、Python 分析脚本和 research-insight Skill，对 GitLink 科研类仓库中的仓库信息、README、Issue、PR、Commit、贡献者、文件结构和协作记录进行采集与分析，输出科研项目洞察、复现合规审计、科研进度周报、风险预警、行动优先级建议、可视化页面和真实仓库验证包。

作品定位

主攻赛题：子赛题四“应用 GitLink 辅助科研”。
能力融合：子赛题二的自定义 Skill 与子赛题三的端到端自动化工作流。
服务对象：科研项目负责人、课程型科研团队、开源科研仓库维护者和需要复盘协作过程的课题组。
核心价值：把 GitLink 平台上的开源协作数据转化为科研项目管理、复现检查、风险识别和成果展示材料。

核心能力

能力	说明	关键产物
数据采集	通过 `gitlink-cli` 与 OpenAPI 获取仓库、Issue、PR、Commit、README、贡献者和目录结构	`scripts/collect_gitlink_data.py`、`outputs/raw/`
指标分析	计算协作状态、贡献者分布、复现性检查项、风险信号和科研主题关键词	`scripts/analyze_research_repo.py`、`outputs/metrics.json`
报告生成	自动生成项目洞察、复现审计、周报、风险预警和行动优先级建议	`scripts/generate_reports.py`、`outputs/*.md`
可视化展示	将主题演进、协作结构和复现性风险转成 HTML 展示页	`scripts/render_research_graph.py`、`outputs/research-graph.html`
Agent Skill	将科研洞察流程封装成可复用的 Agent Skill	`skills/research-insight/`
端到端工作流	串联采集、分析、报告生成和运行日志，支持 PowerShell 与 Bash	`workflows/run-research-insight.ps1`、`workflows/run-research-insight.sh`
验证归档	将报告、日志、截图和校验信息整理为真实仓库验证包	`scripts/build_validation_bundle.py`、`outputs/validated/`

快速运行

运行前请确认已经安装 Python 与 gitlink-cli，并完成 GitLink 登录认证：

gitlink-cli auth status
python --version

在项目根目录执行一键工作流：

powershell -ExecutionPolicy Bypass -File .\workflows\run-research-insight.ps1 `
  -Owner p58142970 `
  -Repo OpenClaw-Course `
  -Branch master

分析其他仓库时，只需要替换 Owner、Repo 和输出目录。例如：

powershell -ExecutionPolicy Bypass -File .\workflows\run-research-insight.ps1 `
  -Owner Lab4AI `
  -Repo AI_Paper `
  -Branch master `
  -OutputDir outputs\samples\Lab4AI-AI_Paper

Bash 环境可使用：

bash ./workflows/run-research-insight.sh \
  --owner p58142970 \
  --repo OpenClaw-Course \
  --branch master

完整使用说明见 docs/项目使用文档.md。

输出成果

文件	用途
outputs/project-insight-report.md	科研仓库定位、协作特征、关键发现和建议动作
outputs/reproducibility-audit.md	许可证、依赖、文档、实验入口和工程化检查
outputs/research-weekly-report.md	近 7 天 Issue、PR、Commit 与项目状态摘要
outputs/risk-alerts.md	协作、复现、工程化和项目管理风险清单
outputs/action-priority.md	当前最值得优先推进的整改动作
outputs/research-graph.html	科研主题、贡献者、协作状态和风险的可视化页面
outputs/topic-evolution.md	从仓库内容中提取的主题演进摘要
outputs/run-log.md	端到端工作流运行日志与产物检查

真实仓库验证

项目已在两个真实 GitLink 科研类仓库上完成验证，使用同一套脚本、同一条工作流和同一种验证包结构。

验证仓库	Issue(open/closed)	PR(open/merged)	Contributor	复现性评分	验证包
`p58142970/OpenClaw-Course`	6 / 5	2 / 2	3	65	outputs/validated/p58142970-OpenClaw-Course/
`Lab4AI/AI_Paper`	5 / 10	3 / 0	5	65	outputs/validated/Lab4AI-AI_Paper/

验证说明见 docs/multi-repo-validation.md。

项目结构

gitlink-research-insight-agent/
├── README.md
├── scripts/                  # 数据采集、指标分析、报告生成、可视化和验证包脚本
├── workflows/                # PowerShell / Bash 端到端运行入口
├── skills/research-insight/  # 自定义科研洞察 Agent Skill
├── docs/                     # 使用说明、架构说明、提交说明和评分证据
├── examples/                 # 面向官方生态回流的示例材料
├── doc/                      # 科研 Agent 使用指南
├── outputs/                  # 已生成的报告、指标、可视化和验证包
└── assets/                   # 截图与演示素材

赛题要求对照

赛事要求	本项目对应材料
科研辅助分析脚本	`scripts/collect_gitlink_data.py`、`scripts/analyze_research_repo.py`、`scripts/generate_reports.py`
自动化工作流	`workflows/run-research-insight.ps1`、`workflows/run-research-insight.sh`
工具代码	`scripts/render_research_graph.py`、`scripts/build_validation_bundle.py`
完整中文使用文档	docs/项目使用文档.md
场景输出成果	`outputs/project-insight-report.md`、`outputs/reproducibility-audit.md`、`outputs/research-graph.html`
可复现执行脚本	`workflows/run-research-insight.*` 与 `outputs/run-log.md`
演示截图	`assets/screenshots/`
真实 GitLink 科研仓库验证	`outputs/validated/p58142970-OpenClaw-Course/`、`outputs/validated/Lab4AI-AI_Paper/`
科研场景应用报告	docs/项目使用文档.md、docs/scoring-evidence.md
官方生态回流材料	`examples/research/research-insight/`、`examples/workflows/research-weekly/`、`doc/research-agent-guide.md`

项目亮点

以真实 GitLink 数据为依据，报告结论可追溯到 raw JSON、指标文件和运行日志。
从“看见问题”推进到“给出动作”，action-priority.md 会把复现短板、开放 PR 和热点 Issue 排成可执行清单。
同一工作流已在两个真实科研仓库上复用，验证了方案的泛化性。
输出同时覆盖 Markdown 报告、HTML 图谱、截图证据和验证包，便于复核、展示和二次使用。
Skill、工作流示例和科研指南已经按官方资源包结构整理，便于后续贡献到 gitlink-cli 生态。