feat(research): 新增科研辅助开发模板 examples/research(补齐起步资源包缺失项) #418

Merged
wbtiger merged 1 commits from Taoyouce/gitlink-cli:feat/research-template into master 2026-07-14 20:43:11 +08:00
Contributor

背景

起步资源包计划提供 examples/research/(科研场景脚本、分析工具、报告生成模板),但主仓库至今没有该目录——既有科研类贡献均为具体 Skill/工作流,缺一个供他人二次开发的通用脚手架。

内容

新增 examples/research/ 三件套:

  • scripts/research_tool_template.py:采集(gitlink-cli)→ 指标(确定性纯函数)→ 报告渲染 三段式骨架,纯标准库;自带可运行示例「仓库科研活跃度快照」;时间基准经 --now 注入保证可复现
  • report-template.md:占位符报告模板,固化「结论/指标/证据/复现命令」四元组结构——科研结论必须任何人可独立复核
  • tests/test_metrics.py:9 个指标纯函数单测(含 close_rate 边界、包裹形状兼容、确定性断言),不访问网络
  • README.md:快速运行 + 3 步改造指南 + 子赛题四评审要点(可复现/确定性/零依赖)

生产验证(2026-07-10)

Gitlink/forgeplus 实测出报告:开放 35 / 已关闭 4163 / 关闭率 99% / open PR 7 / 分支 7 / 近 30 天活跃「是」,全部指标可用报告内嵌命令独立复核。单测 9/9 通过。

## 背景 起步资源包计划提供 `examples/research/`(科研场景脚本、分析工具、报告生成模板),但主仓库至今没有该目录——既有科研类贡献均为具体 Skill/工作流,缺一个供他人二次开发的通用脚手架。 ## 内容 新增 `examples/research/` 三件套: - `scripts/research_tool_template.py`:采集(gitlink-cli)→ 指标(确定性纯函数)→ 报告渲染 三段式骨架,纯标准库;自带可运行示例「仓库科研活跃度快照」;时间基准经 `--now` 注入保证可复现 - `report-template.md`:占位符报告模板,固化「结论/指标/证据/复现命令」四元组结构——科研结论必须任何人可独立复核 - `tests/test_metrics.py`:9 个指标纯函数单测(含 close_rate 边界、包裹形状兼容、确定性断言),不访问网络 - `README.md`:快速运行 + 3 步改造指南 + 子赛题四评审要点(可复现/确定性/零依赖) ## 生产验证(2026-07-10) Gitlink/forgeplus 实测出报告:开放 35 / 已关闭 4163 / 关闭率 99% / open PR 7 / 分支 7 / 近 30 天活跃「是」,全部指标可用报告内嵌命令独立复核。单测 9/9 通过。
Taoyouce added 6 commits 2026-07-11 00:16:59 +08:00
wbtiger merged commit fefcd70dd2 into master 2026-07-14 20:43:11 +08:00
Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#418
No description provided.