feat: 添加两个科研分析 Skill
This commit is contained in:
parent
8ef201810b
commit
5404a48bd3
|
|
@ -0,0 +1,109 @@
|
|||
---
|
||||
name: research-insight-extractor
|
||||
version: 1.0.0
|
||||
description: "从 GitLink 科研仓库的 commit 历史、README 文档、代码变更中自动提炼研究思路、技术迭代脉络、创新点，辅助科研复盘与新 Idea 生成；支持 OpenClaw、Claude Code、Cursor 等 Agent 自动触发。"
|
||||
license: MulanPSL-2.0
|
||||
metadata:
|
||||
requires:
|
||||
bins_any: ["gitlink-cli"]
|
||||
bins_note: "依赖 gitlink-cli 获取 commit 日志、README 内容等，需配置 GITLINK_TOKEN 环境鉴权变量"
|
||||
cliHelp: "gitlink-cli repo --help"
|
||||
platforms:
|
||||
agents:
|
||||
- openclaw
|
||||
- claude-code
|
||||
- cursor
|
||||
- generic-agent
|
||||
backends:
|
||||
- id: gitlink
|
||||
cli: gitlink-cli
|
||||
url_template: "https://www.gitlink.org.cn/{owner}/{repo}"
|
||||
raw_template: "https://www.gitlink.org.cn/{owner}/{repo}/raw/master/{path}"
|
||||
api_base: "https://www.gitlink.org.cn/api/v1"
|
||||
auth_env: GITLINK_TOKEN
|
||||
default: true
|
||||
---
|
||||
# research-insight-extractor 科研思路提炼 Skill
|
||||
## **CRITICAL — 所有仓库查询执行前必须校验 gitlink-cli 鉴权状态，GITLINK_TOKEN 缺失/失效直接终止流程并提示用户配置环境变量。**
|
||||
## **CRITICAL — 本技能仅读取仓库公开数据（commit 历史、README、文件树），不进行任何写入操作，无需用户确认步骤。**
|
||||
|
||||
## 功能概述
|
||||
本 Skill 为 C1 纯文档模式，Agent 直接按内置流程执行：
|
||||
1. 解析用户指令，提取仓库 `owner/repo` 及分析范围（如最近 N 次 commit、特定版本区间）；
|
||||
2. 调用 gitlink-cli 拉取 commit 历史、README 内容、文件树；
|
||||
3. 使用 AI 语义分析技术，从 commit 消息、文档变更中提取：
|
||||
- **研究思路**：项目要解决的科学问题、方法论选择
|
||||
- **技术迭代脉络**：关键版本演进、算法替换、架构调整
|
||||
- **创新点**：区别于同类工作的新方法、新特性
|
||||
4. 输出结构化科研洞悉报告，为科研复盘与新 Idea 生成提供直接参考。
|
||||
|
||||
## 触发场景
|
||||
用户输入包含以下关键词/意图时激活：
|
||||
- "提炼XX仓库的研究思路"
|
||||
- "分析XX项目的技术迭代脉络"
|
||||
- "找出XX的创新点"
|
||||
- "科研复盘XX仓库"
|
||||
- "从XX仓库生成研究灵感"
|
||||
|
||||
## 输入提取规则
|
||||
从用户语句中拆分仓库标识 `owner/repo`，同时可选提取：
|
||||
- `--since` 起始日期
|
||||
- `--until` 结束日期
|
||||
- `--max-commits` 最大分析提交数（默认 100）
|
||||
|
||||
## 执行流程
|
||||
1. 从用户输入提取 owner、repo、时间范围参数。
|
||||
2. 依次执行以下命令获取原始数据：
|
||||
```bash
|
||||
gitlink-cli repo +readme --owner <owner> --repo <repo>
|
||||
gitlink-cli repo +tree --owner <owner> --repo <repo>
|
||||
gitlink-cli commit list --repo <owner>/<repo> --format json --limit <max> --since <date> --until <date>
|
||||
```
|
||||
（若 commit 命令不支持 --since，则先拉取全部最近提交，后续由 Agent 按时间过滤）
|
||||
3. 解析 commit 消息，结合 README 和目录结构，提炼：
|
||||
(1)核心研究问题：从 README 标题、描述、commit 中高频词提取
|
||||
(2)技术路线变化：commit 里出现“replace”“migrate”“refactor”“upgrade”等关键词对应的变更
|
||||
(3)创新功能引入：commit 里出现“add”“introduce”“new”“support”等关键词对应的新模块
|
||||
(4)实验策略演进：目录树中 experiments/、scripts/、configs/ 下新增或修改的文件
|
||||
(5)生成科研洞悉报告（严格按输出模板）。
|
||||
|
||||
## 输出模板
|
||||
### 项目核心研究问题
|
||||
[从 README 与高频 commit 主题中总结出 1-2 句话，点明该项目要解决的科学问题]
|
||||
|
||||
### 技术迭代脉络
|
||||
按时间顺序列出关键版本或重要提交节点：
|
||||
|
||||
| 时间 | 版本/提交 | 技术变化 | 影响 |
|
||||
|------|----------|---------|------|
|
||||
| YYYY-MM-DD | [commit hash 或 tag] | [简述变更] | [对性能、实验的影响] |
|
||||
（至少列出 3-5 个关键节点，若数据不足则注明“镜像仓库历史有限”）
|
||||
|
||||
### 核心创新点
|
||||
[创新点 1]：[简要描述 + 在代码中的体现（文件名或模块）]
|
||||
[创新点 2]：[简要描述]
|
||||
（提取 2-4 个创新点，每个附 evidence）
|
||||
|
||||
### 研究思路总结
|
||||
[用一段话概括该项目的研究范式：问题定义 → 方法论选择 → 实验验证 → 迭代优化，突出科研逻辑]
|
||||
|
||||
### 新 Idea 启发
|
||||
基于以上分析，为研究者提供 2-3 个可延伸的研究方向或改进思路：
|
||||
[例如：将项目中方法应用于另一领域]
|
||||
[例如：针对已知局限性的改进方案]
|
||||
[例如：结合其他技术的交叉创新]
|
||||
|
||||
## 使用示例
|
||||
用户：提炼 NSCCN/AlphaFold3 的技术迭代脉络和创新点，分析最近 100 次提交
|
||||
|
||||
Agent 行为：
|
||||
1. 解析参数，执行命令获取数据
|
||||
2. 从 commit 中发现：
|
||||
(1)早期提交大量引入 Evoformer 模块。
|
||||
(2)中期“refactor: replace Pairformer with simplified pairformer”。
|
||||
(3)后期新增“diffusion_head”目录。
|
||||
3. 生成报告（示例摘要）：
|
||||
核心研究问题：高精度蛋白质复合体结构预测
|
||||
技术迭代：Evoformer → 轻量 Pairformer → Diffusion Head → 多链支持
|
||||
创新点：扩散模型精修、轻量化编码器、多链复合体支持
|
||||
新 Idea：将扩散模块独立为通用后处理插件，探索与 ESM 语言模型结合
|
||||
|
|
@ -0,0 +1,128 @@
|
|||
---
|
||||
name: research-mirror-analyzer
|
||||
version: 1.0.0
|
||||
description: "自动化分析 GitLink 科研仓库活跃度、贡献者生态，调用 gitlink-cli 拉取仓库代码统计、贡献者原始数据，自动计算指标并输出结构化科研项目洞察报告；支持 OpenClaw、Claude Code、Cursor 等多类 AI Agent 自动触发执行。"
|
||||
license: MulanPSL-2.0
|
||||
metadata:
|
||||
requires:
|
||||
bins_any: ["gitlink-cli"]
|
||||
bins_note: "仅依赖官方 gitlink-cli，用于拉取仓库代码统计、贡献者列表 JSON 数据，需提前配置 GITLINK_TOKEN 环境鉴权变量"
|
||||
cliHelp: "gitlink-cli repo --help"
|
||||
platforms:
|
||||
agents:
|
||||
- openclaw
|
||||
- claude-code
|
||||
- cursor
|
||||
- generic-agent
|
||||
backends:
|
||||
- id: gitlink
|
||||
cli: gitlink-cli
|
||||
url_template: "https://www.gitlink.org.cn/{owner}/{repo}"
|
||||
raw_template: "https://www.gitlink.org.cn/{owner}/{repo}/raw/master/{path}"
|
||||
api_base: "https://www.gitlink.org.cn/api/v1"
|
||||
auth_env: GITLINK_TOKEN
|
||||
default: true
|
||||
---
|
||||
# research-mirror-analyzer 科研仓库活跃度分析 Skill
|
||||
## **CRITICAL — 所有仓库查询操作执行前必须校验 gitlink-cli 鉴权状态，GITLINK_TOKEN 缺失/失效直接终止流程并提示用户配置环境变量。**
|
||||
## **CRITICAL — 开始前必须先阅读 [`../gitlink-shared/SKILL.md`](https://www.gitlink.org.cn/Gitlink/gitlink-cli/tree/master/skills/gitlink-shared/SKILL.md)（仅 GitLink 后端）或对应平台的 CLI 文档。所有 GitHub 操作必须使用 `gh`；所有 GitLab 操作必须使用 `glab`；所有 GitLink 操作必须使用 `gitlink-cli`。禁止混用或替代。**
|
||||
## **CRITICAL — 调用 gitlink-cli 拉取数据后必须校验返回 JSON 结构，关键字段缺失、空数据时终止分析并返回异常提示。**
|
||||
## **CRITICAL — 本技能仅读取仓库统计数据，无任何 Issue/代码/仓库写入操作，无需 dry-run 预览、无需用户确认步骤。**
|
||||
|
||||
## 功能概述
|
||||
本 Skill 为 C1 纯文档模式，规则与执行逻辑全部内嵌本文档，无需外部配置文件，Agent 可直接按内置流程执行完整分析链路：
|
||||
1. 解析用户自然语言指令，提取仓库 `owner` / `repo` 标识；
|
||||
2. 调用 gitlink-cli 批量拉取仓库代码统计、贡献者原始 JSON 数据；
|
||||
3. 解析代码行数、总提交、贡献者分布指标；
|
||||
4. 计算贡献集中度、活跃度分级；
|
||||
5. 输出标准化 Markdown 科研仓库评估报告。
|
||||
|
||||
## 触发场景
|
||||
用户输入包含以下关键词/意图时自动激活本 Skill：
|
||||
- "分析仓库XX的科研活跃度"
|
||||
- "评估XX仓库贡献者集中度"
|
||||
- "查看科研仓库代码统计"
|
||||
- "拉取仓库贡献者数据并生成报告"
|
||||
- 携带 `owner/repo` 仓库路径并要求做活跃度评估
|
||||
|
||||
## 输入提取规则
|
||||
从用户语句中拆分仓库标识，格式固定为 `owner/repo`：
|
||||
示例：`NSCCN/AlphaFold3`
|
||||
拆分结果：owner = NSCCN, repo = AlphaFold3
|
||||
未识别到合法 `owner/repo` 格式时，提示用户补充完整仓库地址。
|
||||
|
||||
## 平台与鉴权
|
||||
本 Skill 默认针对 GitLink 平台，Agent 执行时直接使用 `gitlink-cli`，无需检测其他后端。
|
||||
鉴权检查：若 gitlink-cli 命令返回 “authentication required” 或类似鉴权错误，则提示用户配置 `GITLINK_TOKEN` 环境变量后重试；否则继续执行。
|
||||
|
||||
## 执行流程
|
||||
1. 从用户输入提取 owner 和 repo（如 “NSCCN/AlphaFold3” 拆分为 owner=NSCCN, repo=AlphaFold3）。
|
||||
2. 依次执行以下命令（agent 需模拟 shell 执行，在无法真实执行的环境中可要求用户提供命令输出）：
|
||||
```bash
|
||||
gitlink-cli repo +code-stats --owner <owner> --repo <repo> --format json
|
||||
gitlink-cli repo +contributors --owner <owner> --repo <repo> --format json
|
||||
```
|
||||
3. 解析返回的 JSON，提取 additions, deletions, commit_count, author_count, authors 数组。
|
||||
4. 若解析失败或关键字段缺失，终止分析并返回错误信息。
|
||||
5. 按照下方输出模板生成科研项目洞察报告。
|
||||
|
||||
## 输出模板
|
||||
分析完成后，必须严格按以下 Markdown 格式输出，不得省略任何小节：
|
||||
|
||||
### 项目总览
|
||||
仓库全名：[full_name 或用户提供的仓库标识]
|
||||
总新增代码行数：[additions] 行
|
||||
总删除代码行数：[deletions] 行
|
||||
总提交次数：[commit_count]
|
||||
贡献者总数：[author_count]
|
||||
|
||||
### 核心贡献者 Top3
|
||||
| 排名 | 贡献者 | 提交次数 | 占总提交比例 |
|
||||
|------|--------|----------|------------|
|
||||
| 1 | [name] | [commits] | [百分比]% |
|
||||
| 2 | [name] | [commits] | [百分比]% |
|
||||
| 3 | [name] | [commits] | [百分比]% |
|
||||
|
||||
### 活跃度评估
|
||||
等级：[高/中/低]
|
||||
高：commit_count > 500
|
||||
中：100 ≤ commit_count ≤ 500
|
||||
低：commit_count < 100
|
||||
|
||||
### 科研协作建议
|
||||
若 Top1 提交占比 > 80%：
|
||||
项目高度集中于单一开发者，代码质量可能较高，但外部贡献门槛高。建议作为算法学习与复现的参考，参与时优先通过 Issue 讨论。
|
||||
|
||||
若贡献者分布较均匀：
|
||||
社区开放度较高，适合研究者参与代码贡献和多团队协作。
|
||||
|
||||
## 使用示例
|
||||
用户：分析 NSCCN/AlphaFold3 的科研活跃度
|
||||
|
||||
Agent 行为：
|
||||
提取 owner=NSCCN, repo=AlphaFold3
|
||||
尝试执行 gitlink-cli 命令（若无执行环境，则提示用户提供数据，或在用户提供 JSON 后继续）
|
||||
假设获得以下数据（模拟）：
|
||||
additions: 83809, deletions: 16005, commit_count: 244, author_count: 14
|
||||
top authors: Augustin Zidek (206 commits), Josh Abramson (11), James Spencer (9)
|
||||
|
||||
生成报告：
|
||||
### 项目总览
|
||||
仓库全名：NSCCN/AlphaFold3
|
||||
总新增代码行数：83809 行
|
||||
总删除代码行数：16005 行
|
||||
总提交次数：244
|
||||
贡献者总数：14
|
||||
|
||||
### 核心贡献者 Top3
|
||||
| 排名 | 贡献者 | 提交次数 | 占总提交比例 |
|
||||
|-----|---------|---------|------------|
|
||||
| 1 | Augustin Zidek | 206 | 84.4% |
|
||||
| 2 | Josh Abramson | 11 | 4.5% |
|
||||
| 3 | James Spencer | 9 | 3.7% |
|
||||
|
||||
### 活跃度评估
|
||||
等级：中等
|
||||
|
||||
### 科研协作建议
|
||||
该项目高度集中于 Augustin Zidek（84.4% 提交），适合作为核心算法参考，建议在 GitLink 源仓库参与讨论或提交 Issue。
|
||||
Loading…
Reference in New Issue