一套可装进任意 AI 助手的 CFA 一级备考辅导框架（skill）：在 Claude Code、ChatGPT、Gemini、 Cursor 等工具里，把 AI 变成专为几乎零金融基础考生设计的私人辅导老师。它会：

• 🧠 通俗讲解难点——用生活化类比和具体例子讲清概念，每个术语都解释，绝不用术语解释术语；
• 🎯 拆解例题、指出考点——告诉你"这道题到底在考什么"，逐步解题，并说明每个错误选项的陷阱；
• 📝 生成同考点练习题——按真实 CFA 单选（A/B/C）风格出题帮你巩固；
• 📖 扎根你自己的资料——可读取你上传的备考资料全文，用你教材里的原话、记号和例题来讲，而不是泛泛而谈。

回答采用中英对照：解释用中文，关键术语和题目保留英文（贴近真实英文考试）。

安装 Installation

这是在 Claude Code 里作为原生 skill 安装的方式；其他 AI 工具见下方「在其他 AI 工具上使用」。

把整个文件夹放进你的个人技能目录，Claude Code 会自动发现，无需任何配置：

git clone https://github.com/lyra81604/CFA-skill_cfa-level1-tutor.git \
  ~/.claude/skills/cfa-level1-tutor

需要 Node.js（用于从 Word 资料生成可搜索文本）和系统自带的 unzip。

接入你自己的资料 Connect your own materials

可选，但强烈推荐。

本仓库不含任何教材内容（见下方版权声明）。请用你自己合法持有的备考资料（Word .docx 格式）在本地生成：

cd ~/.claude/skills/cfa-level1-tutor
node scripts/docx-to-text.js "/path/to/your-own-textbook-1.docx" "corpus/book-1.txt"
node scripts/docx-to-text.js "/path/to/your-own-textbook-2.docx" "corpus/book-2.txt"
node scripts/docx-to-text.js "/path/to/your-own-textbook-3.docx" "corpus/book-3.txt"
node scripts/docx-to-text.js "/path/to/your-own-textbook-4.docx" "corpus/book-4.txt"

你可以接入任意数量、任意来源的备考资料——上面只是示例，文件名和数量随你。 只有 PDF？先在 Word 里"打开 → 另存为 .docx"转换即可。 没有资料也能用，技能会退回到通用 CFA 知识，只是无法引用你教材里的具体内容。

使用 Usage

新开一个 Claude Code 会话，三种方式：

1. 直接呼出：/cfa-level1-tutor 解释一下 NPV
2. 自动触发：在学习语境里提问即可，例如"什么是 duration，完全看不懂"，或直接粘贴一段教材 / 一道选择题问"这题考啥"。
3. 出题巩固：例如"给我出 3 道久期的练习题"。

在其他 AI 工具上使用 Use on other AI tools

不止 Claude——本技能的"大脑"是纯文本指令，可部署到 ChatGPT 自定义 GPT、Gemini Gem、Cursor 等。 见 portable/：

• portable/SYSTEM_PROMPT.md — 自包含、工具中性的指令，直接粘进任意平台的"指令框"当系统提示。
• portable/DEPLOY.md — 各平台部署步骤（指令放哪、资料怎么上传）。

目录结构 Structure

cfa-level1-tutor/
├── SKILL.md                      # 技能主文件（行为定义）
├── README.md
├── .gitignore                    # 屏蔽 corpus 与资料源文件
├── references/
│   ├── curriculum-map.md         # 10 大科目、考试权重、各科高频考点
│   └── question-style.md         # 如何写"像真考试"的练习题
├── scripts/
│   └── docx-to-text.js           # 把 .docx 资料提取为可搜索文本
├── portable/                     # 部署到其他 AI 工具（非 Claude）
│   ├── SYSTEM_PROMPT.md          # 自包含、工具中性的通用指令
│   └── DEPLOY.md                 # ChatGPT/Gemini/Cursor 部署步骤
└── corpus/                       # 你的备考资料全文（本地生成，不进仓库）
    └── README.md

已知限制 Limitations

• 公式/图片会丢失：Word 里的公式以图片存储，提取为文本时无法保留（会出现 "calculated as ▢ where…" 这类空缺）。遇到这种情况技能会用标准 CFA 公式补上并说明，必要时可让你贴公式截图核对。
• 面向 CFA Level I（一级）。

版权 Copyright

⚠️ 请认真阅读。

• 本仓库只包含原创的技能代码与说明，不含任何第三方教材内容。
• corpus/*.txt 与 *.docx、*.pdf 已被 .gitignore 屏蔽，请勿提交或分发。
• 你需对自己上传/使用的备考资料拥有合法使用权，并遵守其版权；本工具仅在你本地处理这些资料。
• "CFA®" 和 "Chartered Financial Analyst®" 是 CFA Institute 的注册商标；本项目与 CFA Institute 无任何关联，也未获其背书。

许可 License

技能代码（SKILL.md、references/、scripts/、portable/、README.md）以 MIT 许可发布。 不适用于任何第三方教材内容。