给第一次使用 Codex Skill 的同学准备的一套保研工具。不会写代码也可以使用。
它可以帮助你完成三件事：
- 写个人陈述。
- 写导师套磁信，并在你确认后再正式发送。
- 把零散 PDF 整理成带封面、目录和页码的学校专项资料包。
Skill 可以理解为交给 Codex 的一份专业操作手册。安装后，你只需要上传材料并用一句话指定 Skill，Codex 会按固定流程工作。
| 你的需求 | 使用的 Skill | 直接复制这句话 |
|---|---|---|
| 写或修改个人陈述 | 保研个人陈述写作 | 使用 $baoyan-personal-statement，根据我提供的材料写一份约1000字的中文个人陈述。只使用已确认事实。 |
| 给导师写套磁信 | 保研套磁信制作与投递 | 使用 $baoyan-taocixin-outreach，为这位导师定制套磁信，先给我看草稿，不要发送。 |
| 整理学校申请材料 | 保研资料包制作 | 使用 $baoyan-application-package，把这个文件夹里的PDF整理成某某大学夏令营申请资料包。 |
上面
$后面的英文是 Skill 的内部 ID。Codex 要靠它识别 Skill，所以不能改成中文；你在界面中看到的名称已经是中文。
打开一个新的 Codex 会话，完整复制下面这段话并发送：
请帮我安装这个 GitHub 仓库中的 Codex Skills：
https://github.com/syiibfs-hash/baoyan-skills
请按以下步骤独立完成：
1. 将仓库克隆或下载到临时目录，并先阅读 README.md；
2. 找到仓库的 skills 文件夹；
3. 将 skills 下的 baoyan-personal-statement、baoyan-taocixin-outreach、
baoyan-application-package 三个文件夹复制到我的 Codex Skills 目录；
4. Codex Skills 目录优先使用 $CODEX_HOME/skills；如果没有设置 CODEX_HOME，
则使用 ~/.codex/skills；
5. 不要删除或覆盖其他无关 Skill；如果存在同名 Skill，只更新这三个同名目录；
6. 安装后检查每个目录中是否存在 SKILL.md 和 agents/openai.yaml；
7. 删除下载或克隆产生的临时目录；
8. 告诉我安装结果，并提醒我重新打开 Codex 或新建会话。
这个方法不需要你手动找 Codex 的安装目录，也不需要自己复制文件。
- 点击 GitHub 页面右上角的
Code → Download ZIP。 - 解压下载的文件。
- 在解压后的仓库文件夹中打开 PowerShell，运行：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1- 重新打开 Codex，或者新建一个会话。
在仓库目录中运行：
bash ./scripts/install.sh然后重新打开 Codex。
在 Codex 中发送：
请告诉我是否可以使用 $baoyan-personal-statement、
$baoyan-taocixin-outreach 和 $baoyan-application-package。
如果 Codex 能识别这三个 Skill，就说明安装成功。
- 只让 Codex 写个人陈述或套磁信草稿：通常不需要你手动运行 Python。
- 需要生成套磁信 Word 或保研资料包：Codex 可以代你运行脚本；如果你想自己运行，请安装 Python 和仓库依赖。
- 自己运行脚本前执行：
pip install -r requirements.txt任选一种方式：
- 直接把文件拖入当前会话。
- 告诉 Codex 文件或文件夹的完整路径。
- 在 Codex 工作区中打开材料所在文件夹。
建议一个任务使用一个独立文件夹，避免 Codex 混入旧稿和无关附件。
- 把材料放在一个单独文件夹中，文件名尽量清楚。
- 明确告诉 Codex 哪些信息已经确认，哪些仍然待核对。
- 不要让 Codex猜测排名、奖项、论文状态、导师邮箱或录取结果。
- 涉及真实邮件发送时，必须先检查收件人、主题、正文和附件。
- 身份证、成绩单等敏感材料不要上传到公开仓库。
不必先写成文章。准备一份简单的事实清单即可：
- 姓名、本科院校和专业。
- 申请方向和目标项目。
- 2—4 段重要经历。
- 课程、项目、竞赛、科研或实习中的真实成果。
- 希望重点展现的特点。
- 字数和语言要求。
材料不完整也可以开始。Codex 会先整理已知事实，并标出不能擅自补写的信息。
把事实清单或现有草稿交给 Codex，然后发送：
使用 $baoyan-personal-statement，根据这些材料写一份约1000字的中文个人陈述。
开头先介绍我的身份，用具体经历展示成长和研究兴趣，不要写空话，也不要虚构信息。
把它缩短到800字，保留核心项目和研究方向。
在中文定稿基础上生成自然的英文版，不要逐句硬译。
检查这份个人陈述有没有AI味、事实夸大和重复表达。
- 一份结构完整的个人陈述。
- 按要求生成的不同字数版本。
- 需要时提供中英文对应版本。
- 一份事实缺口和风险提示。
- 申请人的简历或事实清单。
- 导师主页或官方介绍。
- 导师的官方邮箱。
- 准备附上的简历、作品集或其他文件。
- 你的私人确认邮箱。
- 如果已经联系过导师，提供套磁台账。
导师邮箱必须来自学校或实验室官方来源，不能让模型猜。
第一次使用建议先走这个模式：
使用 $baoyan-taocixin-outreach，根据我的简历和导师主页写一封套磁信。
先输出邮件主题、正文和推荐附件，不要发送邮件。
把确认后的套磁信正文制作成正文-only Word。
不要加入标题页、邮件主题、页眉、页脚或说明文字。
先把与正式邮件完全相同的主题、正文和附件发送到我的私人确认邮箱。
发完后停下来，等我明确确认，再发送给导师。
流程固定为：
导师与台账去重
↓
核对官方邮箱和申请人事实
↓
生成套磁信和附件
↓
发送私人确认副本
↓
用户明确确认
↓
正式发送导师
↓
回写套磁台账
如果确认副本发送后又修改了正文或附件，必须重新发送确认副本。
- 针对导师研究方向定制的邮件主题和正文。
- 规范排版的套磁信 Word。
- 建议附件清单。
- 发送前检查结果。
- 正式发送后的消息 ID 和台账记录。
- 目标学校和申请学院或方向。
- 学校官方校徽或官网页面。
- 需要合并的 PDF 材料。
- 学校对文件大小、页数和材料顺序的要求。
- 姓名、本科院校和本科专业。
建议先把 PDF 放进同一个文件夹，并使用清楚的文件名，例如：
01_中文简历.pdf
02_个人陈述.pdf
03_成绩单.pdf
04_成绩排名证明.pdf
05_CET6证明.pdf
06_科研项目摘要.pdf
直接把材料文件夹交给 Codex：
使用 $baoyan-application-package，把这个文件夹里的材料整理成
示例大学计算机学院夏令营申请资料包。
要求：
1. 使用学校官方校徽和主色；
2. 增加封面和目录；
3. 所有页面统一为A4且不能裁切；
4. 添加PDF书签；
5. 每页底部显示“当前页 / 总页数”；
6. 完成后检查封面、目录、第一页正文和最后一页。
Codex 会负责盘点材料、安排顺序、生成配置并运行脚本。
先安装依赖：
pip install -r requirements.txt运行匿名演示：
python .\examples\application-package\make_demo_materials.py
python .\skills\baoyan-application-package\scripts\build_package.py `
--config .\examples\application-package\config.json然后复制示例配置，换成自己的学校信息和 PDF 路径。字段说明见：
- 学校主色封面和官方校标。
- 自动计算页码的目录。
- 统一为 A4 的正文页面。
- PDF 分类书签。
- 每页
当前页 / 总页数页码。 - 封面、目录、首个正文页和末页预览。
| 封面 | 目录 |
|---|---|
 |
 |
可以。个人陈述和套磁信都可以从事实清单开始。不要为了“材料完整”而编造经历。
可以。明确说“只输出草稿，不要发送”即可。
普通用户不需要自己写。让 Codex 读取文件夹并生成配置即可。JSON 主要提供给希望手动运行脚本的用户。
邮件发送后难以撤回。确认副本能让你在真实投递前检查收件人以外的所有内容。
中文是界面显示名；英文是 Codex 识别和调用 Skill 的技术 ID。
不建议。真实材料应保存在私有工作目录，公开仓库只放匿名化示例。
在仓库目录中使用 README 提供的完整命令：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1它只会把本仓库中的三个 Skill 复制到当前用户的 Codex Skills 目录。
依次检查：
- 是否重新打开了 Codex或创建了新会话。
~/.codex/skills/下是否存在三个 Skill 文件夹。- 每个文件夹中是否有
SKILL.md。 - 调用时是否包含完整内部 ID，例如
$baoyan-application-package。
本仓库示例均为虚构信息。准备公开自己的修改版时，请先运行：
python .\scripts\audit_privacy.py . `
--deny "你的真实姓名" `
--deny "你的学号" `
--deny "你的私人邮箱"详细检查规则见 匿名化与发布检查。
python scripts/validate_skills.py
python scripts/audit_privacy.py .GitHub Actions 会自动执行相同检查。
- 不要提交真实简历、身份证、成绩单、证书、套磁台账和邮件导出。
- 不要把私人确认邮箱、真实导师邮箱或本机绝对路径写入公开 Skill。
- 仓库暂未预设开源许可证。正式公开前请根据共享意愿选择许可证。