light0305/light-skills

---

这个项目能帮你做什么？

Light Skills 是一套公开、通用、领域无关的 AI skill 包，用来把一个研究或创新项目从“模糊想法”推进到“可检查的交付物”。

它适合这些场景：

为什么适合科研项目？

• 先读再写：先读文件、数据、日志和论文源，再判断下一步。
• 查不到就标 unknown：事实、DOI、链接、期刊规则和软件版本不靠猜。
• 图表必须可复现：论文图、数据图、实验图走 Python/R 程序化生成。
• 关键节点问用户：选题、创新性、证据强度、投稿目标和继续投入都应有人确认。
• 不依赖私有知识库：公开版不要求 MCP 或本地数据库；最新信息在任务现场核查。

先安装

先进入仓库目录：

git clone https://github.com/Light0305/Light-skills.git
cd Light-skills
$env:PYTHONUTF8="1"

Codex

# 项目级：$REPO\.agents\skills
$env:PYTHONUTF8="1"
python scripts\bootstrap_agent_skills.py --targets agents --mode auto --force

# 全局级：$HOME\.agents\skills
New-Item -ItemType Directory -Force "$HOME\.agents\skills" | Out-Null
Copy-Item -Recurse -Force .\skills\* "$HOME\.agents\skills\"

Claude Code

# 项目级：$REPO\.claude\skills\\SKILL.md
$env:PYTHONUTF8="1"
python scripts\bootstrap_agent_skills.py --targets claude --mode auto --force

# 全局级：$HOME\.claude\skills
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Copy-Item -Recurse -Force .\skills\* "$HOME\.claude\skills\"

OpenCode

# 项目级：$REPO\.opencode\skills\\SKILL.md
$env:PYTHONUTF8="1"
python scripts\bootstrap_agent_skills.py --targets opencode --mode auto --force

# 全局级：$HOME\.config\opencode\skills
New-Item -ItemType Directory -Force "$HOME\.config\opencode\skills" | Out-Null
Copy-Item -Recurse -Force .\skills\* "$HOME\.config\opencode\skills\"

安装后检查：

$env:PYTHONUTF8="1"
python scripts\bootstrap_agent_skills.py --check-only

环境要求

基础环境

• Git
• Python 3.10+
• Windows 上运行 Python 前建议设置：$env:PYTHONUTF8="1"

LaTeX 环境

winget install --id MiKTeX.MiKTeX --accept-package-agreements --accept-source-agreements
latexmk -v
pdflatex --version
xelatex --version
biber --version

用于论文排版、PDF 编译、模板检查。light-typesetting 支持 latexmk、pdfLaTeX、XeLaTeX、LuaLaTeX、BibTeX、Biber；如果本机缺工具，会标记 UNAVAILABLE，不会假装已经排版成功。

R 环境

winget install --id RProject.R --accept-package-agreements --accept-source-agreements
Rscript -e "install.packages(c('ggplot2','scales'), repos='https://cloud.r-project.org')"
$env:PYTHONUTF8="1"
python skills\light-figure\scripts\r_ggplot.py --detect

用于 ggplot2 科研图。没有 R 时，图表技能应先问你：继续用 Python 诚实降级，还是安装/配置 R。

从哪里开始？

你可以按当前状态直接复制下面的 prompt：

技能地图

完整技能一览

科研主线

Light Skills 不是让 AI 闷头从头跑到尾，而是把科研拆成可审计、可回退、可交给用户决策的阶段。

论文 Demo 展示

一个论文Demo示例，方向是环境化学 / 光催化动力学，它展示了从合成数据、分析、程序化图表到 LaTeX PDF 的完整交付形态。

阅读 PDF

图表展示

下面的九宫格科研图由 Python 与 R 生成。

反馈与支持

• 邮箱：[email protected]
• GitHub：@Light0305
• 欢迎 issue / PR / 使用反馈。

许可证

本项目使用 MIT License。