Skip to content
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
findsafeskills safety rating

Markdown

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.