Back to search
source-first
SkillWorks with Claude CodeGitHub
"先有出处(动手之前先找依据):写综述与课程报告前查真实学术文献、核验参考文献真伪并整理上传的 PDF/课件/论文;做课设、毕设与竞赛前查现成开源实现与选题撞车度,确保每条引用可点击验证、每个推荐贴合环境约束。用于文献综述、研究现状、开题报告、课程/读书笔记整理、参考文献核伪,以及“帮我找几篇论文”“参考文献别瞎编”“整理这几个课件 PDF”“帮我核对参考文献真伪”“这个题目是不是烂大街了”“有没有现成开源能直接用”等场景(literature review, related work, citation verification, capstone project, open-source lookup)。不用于凭空写观点文、代写论文正文或整套业务代码,不访问知网及校内系统。"
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/xxiaer--source-first)HTML
<a href="/listings/xxiaer--source-first"><img src="/api/listings/xxiaer--source-first/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 84 lines
- ---
- name: source-first
- description: "先有出处(动手之前先找依据):写综述与课程报告前查真实学术文献、核验参考文献真伪并整理上传的 PDF/课件/论文;做课设、毕设与竞赛前查现成开源实现与选题撞车度,确保每条引用可点击验证、每个推荐贴合环境约束。用于文献综述、研究现状、开题报告、课程/读书笔记整理、参考文献核伪,以及“帮我找几篇论文”“参考文献别瞎编”“整理这几个课件 PDF”“帮我核对参考文献真伪”“这个题目是不是烂大街了”“有没有现成开源能直接用”等场景(literature review, related work, citation verification, capstone project, open-source lookup)。不用于凭空写观点文、代写论文正文或整套业务代码,不访问知网及校内系统。"
- ---
- # 先有出处
- 动手之前先找依据。写内容前先看别人写过什么,写代码前先看有没有现成实现。
- 两条线的道理一样:**先确认东西存不存在,再动手。** 区别只在于找的是文献还是代码。
- ## 走哪条线
- | 用户在做什么 | 走哪条 | 加载 |
- |---|---|---|
- | 写综述、整理笔记、核验参考文献、整理上传 PDF/课件、开题研究现状 | 文献线 | `references/study.md` |
- | 课设、毕设、竞赛选题,问有没有现成项目、能不能复用、要改多少 | 项目线 | `references/project.md` |
- **复合需求处理**:如果用户同一次提问既要查研究现状/文献又要查现成开源实现(如毕设开题调研),**按阶段串行执行**:先走文献线完成综述与引用核验,再清空上下文包袱进入项目线查重与骨架评估,各自按阶段加载对应参考文档,不要把文献规则和代码规则混在一起输出。
- 两条都不像,静默退出,直接按普通任务处理。
- ## 什么时候进入
- **文献线**命中任一条:
- - 要写文献综述、研究现状、开题报告的文献部分
- - 要整理课程笔记、读书笔记、专题资料汇总
- - 上传了 PDF、课件、论文,让你“整理一下”“提炼观点”或“核对参考文献真伪”
- - 问某个方向“有哪些研究”“别人怎么做的”
- - 要把一堆资料做成复习材料或汇报大纲
- **项目线**命中任一条:
- - 说了一个课设、毕设、竞赛题目,问“怎么做”“用什么技术”“有没有现成的”
- - 问某个功能“有没有开源实现”“能不能直接用”
- - 担心自己的选题“是不是已经被人做烂了”
- - 已经动手写了一段,怀疑在重复劳动
- **不进入**:
- - 写议论文、观点文、心得体会、公众号推文(这类没有“依据”这回事)
- - 润色已经写好、出处已经标全的成稿(那是改文字,不是找依据)
- - 让 AI 直接写完一段代码,或者代写论文正文核心章节
- - 明确说了不用管出处,只要个大概
- **退出话术边界**:仅当本技能已被加载、随后发现用户核心诉求明确落入**代写论文正文**或**直接代写整套毕设/课设代码**时,用一句话说明不走本技能,然后按普通任务处理(只说一句,不讲道理)。日常混合对话中顺手写段代码、润色一句话或完全无关的任务,静默退回普通模式,不要生硬打断。
- 判断不清时进入,走最轻的那一档。查一遍的成本,远低于写出一堆假东西。
- ## 两条线共用的四条
- 1. **依据先存在。** 引用要能点开,推荐的项目要能打开。凭记忆写出来的东西一律不算。
- 2. **搜到的东西不等于对的东西。** 标题像不一定是那篇,星数高不一定是你要的。核对了再用。
- 3. **有多少说多少。** 查到三条就说三条,没查到就说没查到。空白本身是结论,不是失败。
- 4. **查够了就停。** 连续两次检索没有新结果,收尾,把剩下的不确定性写出来。
- ## 附件与脚本
- 以下路径均相对于本技能目录(下称 `<skill_dir>`,即本 `SKILL.md` 所在目录;执行脚本时请务必使用 `python <skill_dir>/scripts/...`,不要假定当前工作目录就是技能目录):
- - `references/study.md` — 文献线:引用闸门、三档流程、文献特有的硬规则
- - `references/project.md` — 项目线:排序逻辑、适配判断、创意查重、项目特有的硬规则
- - `references/sources.md` — 文献接口地址、参数、实测状态、不可用源
- - `references/repos.md` — 代码仓库检索方法,含 Gitee 检索策略
- - `references/citation-formats.md` — GB/T 7714 与 APA 第 7 版,含接口字段映射
- - `references/output-templates.md` — 两条线的输出模板和填好的例子
- - `references/setup-guide.md` — 可选环境变量与 Token 配置指南
- - `scripts/lookup.py` — 文献线只读并发检索脚本(支持 `--doi` 反查、`--year-from`、`--abstract`、`--bibtex`、双索引去重)
- - `scripts/github_lookup.py` — 项目线只读检索脚本(含 Trees API `src/`/子目录探测、`--readme` 摘要与许可证风险标记)
- - `scripts/check_environment.py` — 只读环境与接口连通性自检脚本
- **按阶段按需加载**:
- - 文献线:检索阶段读 `study.md` + `sources.md`(优先运行 `python <skill_dir>/scripts/lookup.py`);排版生成阶段再读 `citation-formats.md` + `output-templates.md`。
- - 项目线:检索阶段读 `project.md` + `repos.md`(优先运行 `python <skill_dir>/scripts/github_lookup.py`);输出阶段再读 `output-templates.md`。
- ## 交付前自检
- - [ ] 走了对的那条线(或复合需求已分阶段串行完成),没有把两条线混写成一锅
- - [ ] 确认至少一个检索源正常返回过(非全源请求失败;纯离线第一档整理上传材料除外),否则不能写“研究空白”或覆盖说明
- - [ ] 每条引用 / 每个推荐都能点开验证
- - [ ] 核对过标题、作者、年份(或仓库名、语言、更新时间、许可证风险)
- - [ ] 覆盖情况写清楚了:查了什么、没查什么、哪里是空白
- - [ ] 用户自己的判断和查到的结论分开标注了
README.md · README · 108 lines
- # 先有出处 (`source-first`)
- **动手之前先找依据。** 写内容前查真实文献,写代码前查现成实现;每条引用都可点击核验,每个推荐都贴合你的约束,拒绝凭记忆编造。
- [](LICENSE)
- [](https://github.com/XXiaer/source-first/releases)
- ---
- ## 核心理念
- Agent 在学术综述与课设/毕设场景下最容易犯两个错误:**编造不存在的参考文献**,以及**只按 Star 数推荐跑不起来的工程项目**。
- `source-first` 通过两条独立工作线约束输出质量(若同一提问同时涉及综述与选题查重,则分阶段串行执行):
- | 工作线 | 适用场景 | 核心机制 |
- |---|---|---|
- | **文献线** | 文献综述、研究现状、开题报告、课程笔记整理、上传 PDF/课件提炼、参考文献核伪 | **引用闸门**:所有参考文献必须来自真实接口检索或上传材料;按 GB/T 7714-2015 / APA 第 7 版或 BibTeX 自动映射字段;如实披露中文数据库(知网/万方/维普)覆盖缺口 |
- | **项目线** | 课设、毕设、竞赛选题查重、评估现成开源项目能否复用 | **可运行性优先**:按“能否跑通 → 代码体量(100KB~50MB 黄金区间)→ 中间件依赖复杂度 → 技术栈匹配 → 许可证与维护状态 → Star 数”排序;明确区分“能直接用 / 要改的 / 仅参考思路”与 GPL/无许可证风险 |
- > **不进入场景**:纯观点文/心得体会、已有完整出处的文字润色、直接代写论文正文或整套业务代码。
- ---
- ## 目录结构
- ```text
- source-first/
- ├── SKILL.md # 主技能定义与路由规则
- ├── README.md # 项目说明文档
- ├── LICENSE # MIT 开源许可证
- ├── skill-dependencies.json # 网络端点与可选环境依赖声明
- ├── evals/
- │ └── evals.json # 触发正反例与纪律压力评测集
- ├── references/
- │ ├── study.md # 文献线:引用闸门、三档流程与硬规则
- │ ├── project.md # 项目线:适配排序、创意查重与硬规则
- │ ├── sources.md # 文献接口地址、参数与不可用源说明
- │ ├── repos.md # GitHub/Gitee/通用搜索仓库检索策略
- │ ├── citation-formats.md # GB/T 7714 与 APA 第 7 版字段映射
- │ ├── output-templates.md # 两条线标准输出模板与实测示例
- │ └── setup-guide.md # 可选环境变量与 Token 配置指南
- ├── scripts/
- │ ├── lookup.py # 文献线只读并发检索脚本(DOI 反查、双索引去重、BibTeX)
- │ ├── github_lookup.py # 项目线只读 GitHub 检索、目录与 README 摘要脚本
- │ └── check_environment.py # 只读环境与接口连通性自检脚本
- └── tests/
- └── test_scripts.py # 零网络依赖的单元测试(Mock)
- ```
- ---
- ## 内置检索脚本(零第三方依赖)
- 所有脚本均为**只读**,不写文件、不读本地凭据文件、不起子进程,仅使用 Python 标准库。
- ### 1. 文献并发检索:`scripts/lookup.py`
- 一次并发查询 **Crossref、OpenAlex、arXiv、DBLP**(有 `S2_API_KEY` 时自动包含 **Semantic Scholar**;低相关性的 **DOAJ** 按需通过 `--sources ...,doaj` 启用),支持 DOI + `(标题, 年份)` 双索引去重互补、`--year-from` 年份过滤、DOI 精准反查(HTTP 404 返回退出码 1)与 BibTeX 导出:
- ```bash
- # 并发检索(默认 crossref,openalex,arxiv,dblp)
- python scripts/lookup.py "retrieval augmented generation" --abstract --json
- # 按年份筛选近几年的文献并导出 BibTeX
- python scripts/lookup.py "RAG" --year-from 2023 --limit 3 --bibtex
- # 按 DOI 精准反查(用于核验已有参考文献)
- python scripts/lookup.py --doi 10.1145/3777378 --json
- ```
- ### 2. GitHub 仓库检索:`scripts/github_lookup.py`
- 按课设/毕设适配维度查询 GitHub 仓库(默认过滤 10KB 以下空壳仓与 Fork 仓),支持 Trees API 探测 `src/` 与前后端子目录关键文件、`--readme` 提取运行指南与中间件依赖线索,并标记 `NOASSERTION` 与 Copyleft(GPL/AGPL)许可证风险:
- ```bash
- python scripts/github_lookup.py "图书管理 springboot" --language Java --check-files --readme
- python scripts/github_lookup.py "library management" --pushed-after 2025-01-01 --min-stars 5 --json
- python scripts/github_lookup.py "图书管理" --include-forks --json
- ```
- ### 3. 环境自检:`scripts/check_environment.py`
- 自动使用已配置的环境变量探活公开端点并输出 `ready` / `degraded` / `needs_setup` / `unavailable` 状态(绝不回显密钥):
- ```bash
- python scripts/check_environment.py
- ```
- 可选环境变量配置细节(`GITHUB_TOKEN`、`OPENALEX_API_KEY`、`CROSSREF_MAILTO`、`S2_API_KEY`)见 [references/setup-guide.md](references/setup-guide.md)。
- ---
- ## 安装与使用
- 1. 从 [Releases](https://github.com/XXiaer/source-first/releases) 下载最新发行包(或直接克隆本仓库)。
- 2. 将 `source-first/` 文件夹放入你的 AI Agent 技能目录:
- - `~/.gemini/antigravity/skills/`
- - `~/.workbuddy/skills/`
- - 或项目级 `.agents/skills/`
- 3. 直接向 Agent 提出文献整理、参考文献核验、综述框架或课设/毕设查重需求即可触发。
- ---
- ## 开源许可与更新记录
- - 本项目基于 [MIT License](LICENSE) 开源。
- - 版本更新记录请查看 [GitHub Releases](https://github.com/XXiaer/source-first/releases)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.