amlei-skills 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "amlei-skills",
+  "description": "简历全流程 + Boss直聘搜岗 + 故事生成 + Git 工作流",
+  "skills": [
+    {
+      "name": "amlei-resume",
+      "file-path": ".opencode/skills/amlei-resume/SKILL.md",
+      "description": "简历全流程：0→1 写/改/换岗/迭代 + Boss直聘搜岗 + 装配 HTML 导出 PDF"
+    },
+    {
+      "name": "amlei-story-generator",
+      "file-path": "skills/amlei-story-generator/SKILL.md",
+      "description": "故事生成——书/人/事/物/理/案，联网核实后写成引人入胜的长文"
+    },
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 amlei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# Amlei Skills
+
+| Skill | Description |
+|-------|-------------|
+| [amlei-resume](skills/amlei-resume/SKILL.md) | 简历全流程：0→1 写/改/换岗/迭代 + Boss直聘搜岗 + 装配 HTML 导出 PDF |
+| [amlei-story-generator](skills/amlei-story-generator/SKILL.md) | 故事生成——书/人/事/物/理/案，联网核实后写成引人入胜的长文 |
+| [amlei-git-gh](skills/amlei-git-gh/SKILL.md) | Git commit + push + PR 工作流 |
+
+## Install
+
+```bash
+# As Claude Code plugin
+claude plugin install npm:amlei-skills
+
+# Or copy skills manually
+cp -r .skills/amlei-resume .claude/skills/
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "amlei-skills",
+  "version": "0.1.0",
+  "description": "简历全流程 + Boss直聘搜岗 + 故事生成 + Git 工作流 — Claude Code skills",
+  "main": "index.js",
+  "scripts": {},
+  "keywords": [
+    "claude-code",
+    "claude",
+    "skills",
+    "resume",
+    "boss-zhipin",
+    "求职"
+  ],
+  "files": [
+    ".claude-plugin/plugin.json",
+    "skills/amlei-resume/SKILL.md",
+    "skills/amlei-resume/assets/",
+    "skills/amlei-resume/references/",
+    "skills/amlei-resume/scripts/boss_zhipin.py",
+    "skills/amlei-resume/scripts/extract_avatar.py",
+    "skills/amlei-resume/scripts/profile.py",
+    "skills/amlei-resume/scripts/validate_resume.py",
+    "skills/amlei-resume/scripts/wrap_preview.py",
+    "skills/amlei-story-generator/",
+    "skills/amlei-git-gh/",
+    "skills/academic-ref-retrieval/"
+  ],
+  "author": "amlei",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amlei/amlei-skills.git"
+  }
+}

package/skills/academic-ref-retrieval/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: academic-ref-retrieval
+description: 学术论文参考文献检索与格式输出。根据论文主题拆解核心技术，编写脚从权威期刊/数据库(知网、维普、arXiv等)爬取或提取真实论文信息，按标准参考文献格式输出。触发：写论文 / 参考文献 / 查文献 / 检索论文 / 论文参考 / reference retrieval / academic reference。
+argument-hint: "USER_DEFINE DIRECTION THEME ENGLISH_PAPER_NUMBER COUNT_NUMBER"
+---
+
+# Academic Reference Retrieval
+
+你是一名高知 `{USER_DEFINE}`，你的研究方向是 `{DIRECTION}`，需要写一篇以 `{THEME}` 为题的论文。你的任务是检索权威、真实的参考文献。
+
+## 工作流
+
+### 1. 技术分片
+
+将论文主题拆解、分片，提炼出最核心的技术，同时辅以技术泛化。以技术为导向，分析完成该论文需要使用到什么技术，将其设定为参考文献方向。
+
+**示例：**
+> 用户: 写一篇以《基于大语言模型的校园信息智能响应 Agent 系统设计与实现》为题的毕业论文
+> 分片: `LLM`, `AI Model`, `Agent`, `Agent Tool`, `RAG`, `Prompt Engineering`, `Context Engineering`
+
+将分片结果作为后续检索关键词。
+
+### 2. 检索脚本
+
+对每个技术关键词，编写代码脚本从官方权威渠道获取真实论文信息。**不得有预设、手动、模拟行为**——必须真实访问并提取数据。
+
+#### 中文期刊源
+- **知网 CNKI** (`https://www.cnki.net/`)：优先使用其开放 API 或搜索页面爬取
+- **维普** (`https://qikan.cqvip.com/`)：备用中文期刊源
+
+#### 英文期刊源
+- **arXiv** (`https://arxiv.org/`)：开放获取，支持 API 批量查询
+- 其他开放学术数据库（如 IEEE Xplore 开放论文、ACL Anthology、DBLP、PubMed Central 等）
+
+#### 提取信息
+
+每篇文献需提取：
+- **标题** (论文完整标题)
+- **作者** (全部作者)
+- **期刊/出版社/会议**
+- **日期** (发表年份/月份)
+- **DOI / URL** (用于引用和核查)
+
+#### 实现方式
+
+- 检索结果为 **HTML**：用 `python3` + `requests` + `BeautifulSoup` (或 `lxml`) 编写爬虫解析
+- 检索结果为 **PDF**：用 `python3` + `PyMuPDF` (`fitz`) 或 `pdfplumber` 提取元数据和参考文献
+- 优先使用官方 API（如 arXiv API: `http://export.arxiv.org/api/query?search_query=all:{keyword}&start=0&max_results=10`）
+- arXiv API 返回 XML，用 `xml.etree.ElementTree` 解析
+
+#### 示例脚本片段
+
+```python
+# arXiv API 检索
+import urllib.request, xml.etree.ElementTree as ET
+
+keyword = "RAG"
+url = f"http://export.arxiv.org/api/query?search_query=all:{keyword}&start=0&max_results=10"
+with urllib.request.urlopen(url) as f:
+    root = ET.fromstring(f.read())
+ns = {"a": "http://www.w3.org/2005/Atom"}
+for entry in root.findall("a:entry", ns):
+    title = entry.find("a:title", ns).text.strip().replace("\n", " ")
+    authors = [a.find("a:name", ns).text for a in entry.findall("a:author", ns)]
+    published = entry.find("a:published", ns).text[:4]
+    link = entry.find("a:id", ns).text
+    print(f"{', '.join(authors)}. {title}[J]. arXiv, {published}. {link}")
+```
+
+### 3. 筛选与格式
+
+- 文献总数：**至少 `{COUNT_NUMBER}` 篇**（含中英文）
+- 英文文献：**至少 `{ENGLISH_PAPER_NUMBER}` 篇**
+- 以中文文献为主
+- **所有参考文献必须来自权威期刊、学术会议论文集或学术专著** — 不得引用网络文章、新闻、博客、微信公众号、非学术网站等
+
+### 4. 输出格式
+
+按标准参考文献格式输出，每条末尾附 Source URL 供核查：
+
+```
+[1] 作者1, 作者2, 作者3. 论文标题[J]. 期刊名称, 年份, 卷号(期号): 起止页码. https://doi.org/xxx
+[2] Author A, Author B. Paper Title[C]. Proceedings of Conference, Year: 页码. https://arxiv.org/abs/xxxx
+```
+
+**文献类型标识：**
+- `[J]` — 期刊论文 (Journal)
+- `[C]` — 会议论文 (Conference)
+- `[M]` — 专著/图书 (Monograph)
+- `[D]` — 学位论文 (Dissertation)
+- `[P]` — 专利 (Patent)
+
+## 约束
+
+1. **绝对真实**：不得编造作者、标题、出处、页码、DOI — 所有信息必须从检索结果中提取。检索不到的不引用。
+2. **代码先行**：必须先编写并执行检索脚本，拿到结果后再整理输出。禁止凭知识或记忆手动列出参考文献。
+3. **来源权威**：只从学术期刊、会议论文集、学术专著中引用。行业报告、技术博客、官方文档等仅作为背景参考，不作为参考文献。
+4. **数量达标**：总文献数不低于 `{COUNT_NUMBER}`，英文不低于 `{ENGLISH_PAPER_NUMBER}`。不足则更换关键词或扩展检索范围。
+
+## 资源
+
+- `resources/arxiv-api-example.py` — arXiv API 检索示例脚本
+- `resources/cnki-scraper-example.py` — 知网检索示例脚本（需处理反爬）

package/skills/academic-ref-retrieval/resources/arxiv-api-example.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+"""arXiv API 检索示例 — 按关键词查论文并输出参考文献格式."""
+
+import sys
+import xml.etree.ElementTree as ET
+from urllib.request import urlopen
+from urllib.parse import quote
+
+API = "http://export.arxiv.org/api/query?search_query=all:{kw}&start=0&max_results={n}"
+NS = {"a": "http://www.w3.org/2005/Atom"}
+
+
+def fetch(keyword, max_results=10):
+    url = API.format(kw=quote(keyword), n=max_results)
+    with urlopen(url) as f:
+        return ET.fromstring(f.read())
+
+
+def parse(root):
+    papers = []
+    for entry in root.findall("a:entry", NS):
+        title = entry.find("a:title", NS).text.strip().replace("\n", " ").replace("  ", " ")
+        authors = [a.find("a:name", NS).text for a in entry.findall("a:author", NS)]
+        published = entry.find("a:published", NS).text[:10]
+        link = entry.find("a:id", NS).text
+        papers.append({"title": title, "authors": authors, "date": published, "url": link})
+    return papers
+
+
+def format_ref(papers, start=1):
+    for i, p in enumerate(papers, start):
+        authors = ", ".join(p["authors"])
+        year = p["date"][:4]
+        print(f"[{i}] {authors}. {p['title']}[J]. arXiv, {year}. {p['url']}")
+
+
+if __name__ == "__main__":
+    kw = sys.argv[1] if len(sys.argv) > 1 else "RAG"
+    n = int(sys.argv[2]) if len(sys.argv) > 2 else 10
+    root = fetch(kw, n)
+    papers = parse(root)
+    format_ref(papers)

package/skills/academic-ref-retrieval/resources/cnki-scraper-example.py

@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+"""知网 CNKI 检索示例 — 按关键词搜索并提取论文元信息.
+
+知网有反爬机制，此脚本演示基础请求 + HTML 解析思路。
+实际使用时可能需要处理 cookie / session / 验证码。
+"""
+
+import sys
+import re
+import urllib.parse
+from urllib.request import urlopen, Request
+
+SEARCH_URL = (
+    "https://kns.cnki.net/kcms2/article/adv search?"
+    "dbcode=CJFD&filename=&tab=AdvanceSearch&"
+    "keyword={kw}&searchType=AdvanceSearch"
+)
+
+
+def fetch(keyword):
+    url = SEARCH_URL.format(kw=urllib.parse.quote(keyword))
+    req = Request(url, headers={"User-Agent": "Mozilla/5.0"})
+    with urlopen(req) as f:
+        return f.read().decode("utf-8", "ignore")
+
+
+def parse(html):
+    """极简示例：从 HTML 提取论文条目（知网页面结构复杂，实际需精细解析）。"""
+    papers = []
+    # 匹配典型条目模式：标题链接 + 作者 + 来源 + 日期
+    blocks = re.findall(
+        r'<tr[^>]*>.*?<a[^>]*href="([^"]*)"[^>]*>([^<]+)</a>.*?'
+        r'<td[^>]*>([^<]+)</td>.*?'
+        r'<td[^>]*>([^<]+)</td>.*?'
+        r'<td[^>]*>(\d{4})</td>',
+        html, re.S
+    )
+    for href, title, authors, source, year in blocks:
+        papers.append({
+            "title": title.strip(),
+            "authors": authors.strip(),
+            "source": source.strip(),
+            "year": year,
+            "url": "https://kns.cnki.net" + href if href.startswith("/") else href,
+        })
+    return papers
+
+
+def format_ref(papers, start=1):
+    for i, p in enumerate(papers, start):
+        print(f"[{i}] {p['authors']}. {p['title']}[J]. {p['source']}, {p['year']}. {p['url']}")
+
+
+if __name__ == "__main__":
+    kw = sys.argv[1] if len(sys.argv) > 1 else "大语言模型"
+    html = fetch(kw)
+    papers = parse(html)
+    format_ref(papers)

package/skills/amlei-git-gh/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: amlei-git-gh
+description: Guide for git commit, push, and PR using gh CLI (GitHub). Use when committing code, pushing to remote, creating pull requests, managing branches, or any git workflow. Covers commit message conventions, push strategies, and PR creation with confirmation gates.
+argument-hint: "[回车=commit&push] 1=staged files 2=unstaged files"
+disable-model-invocation: true
+---
+# Git & GitHub Workflow
+Use `gh` CLI (GitHub) for all remote operations. Commit and push directly without confirmation. Only PR requires explicit user approval.
+## ⚠️ CRITICAL CONSTRAINT
+**NEVER automatically commit and push after making edits.**
+This skill should ONLY activate when:
+- User explicitly asks: "commit", "push", "create PR", "提交", "推送"
+- User invokes: `/git-gh` command
+- User explicitly requests git operations
+**DO NOT:**
+- Auto-commit after editing files
+- Suggest committing after each change
+- Be proactive about git operations
+**WAIT for the user to initiate.**
+## Interactive Mode
+When this skill is invoked, immediately run `git status --short` in the background, then ask the user to choose via `AskUserQuestion`:
+**Options:**
+| # | Option | Action |
+|---|--------|--------|
+| 默认/回车 | Commit & Push | Execute full commit + push flow (Section 1 + 2) |
+| 1 | Staged Files | Show `git diff --cached --stat` + `git diff --cached`, then ask next action |
+| 2 | Unstaged Files | Show `git status --short` + `git diff --stat`, then ask next action |
+**Flow after viewing files (option 1 or 2):**
+- Ask user: proceed to commit & push / stage or unstage specific files / go back
+- After staging/unstaging, loop back to the choice menu
+## 1. Commit
+### Before Committing
+Run in parallel to gather context:
+- `git status` — untracked and modified files
+- `git diff` — staged and unstaged changes
+- `git log --oneline -10` — recent commit style
+### Commit Message Rules
+- Write in **Chinese or English** depending on the project's existing commit style
+- Format: `type: short summary` — one line, concise, human-readable
+- Types: `feat`, `fix`, `refactor`, `docs`, `chore`, `test`, `style`, `perf`
+- Focus on **what changed and why**, not how
+- No emojis unless user requests
+### Good Examples
+```
+feat: add user login with email verification
+fix: resolve race condition in batch processing
+refactor: extract validation logic into shared module
+docs: update API endpoint descriptions
+chore: upgrade dependencies to latest stable
+```
+### Bad Examples
+```
+update files                          # too vague
+feat: add feature                     # which feature?
+wip                                   # meaningless
+fix bug                               # what bug?
+```
+### Steps
+1. Gather context (status, diff, recent log) — run in parallel
+2. Stage specific files by name (`git add <file>`), avoid `git add -A`
+3. Draft commit message based on actual changes
+4. Create commit directly
+5. Run `git status` to verify
+Never commit files that likely contain secrets (.env, credentials).
+## 2. Push
+### Steps
+1. Check if branch tracks a remote: `git branch -vv`
+2. If no upstream, push with: `git push -u origin <branch>`
+3. If upstream exists: `git push`
+4. **Never force push** unless user explicitly requests
+### Current Branch Check
+After commit, check if current branch is not `main`/`master`. If on a feature branch and commit + push succeeded, proceed to step 3.
+## 3. Pull Request
+### When to Ask
+After a successful commit + push on a **non-main branch**, ask the user:
+> Commit and push completed. Would you like to create a pull request?
+**Never create a PR automatically.** Always wait for explicit user confirmation.
+### When NOT to Ask
+- Already on `main` or `master`
+- User only asked to commit (not push)
+- PR already exists for this branch
+### PR Creation Steps
+1. Run in parallel to gather full context:
+   - `git status`
+   - `git diff`
+   - `git log main..HEAD --oneline` — all commits on this branch
+   - `git diff main...HEAD` — full diff from base
+2. Analyze all changes, draft title and body
+3. PR title: under 70 chars, concise summary of the change
+4. PR body format:
+```markdown
+## Summary
+- Bullet points of key changes (1-3 items)
+## Test plan
+- Checklist of verification steps
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+```
+5. Present to user for approval — include suggested labels, assignees, reviewers
+6. Push with `-u` if needed, then create via `gh pr create`
+7. Return the PR URL
+### PR Metadata
+When creating a PR, suggest and apply labels, assignees, and reviewers:
+| Parameter | Flag | Example |
+|-----------|------|---------|
+| Labels | `--label` | `--label "enhancement,backend"` |
+| Assignees | `--assignee` | `--assignee "user1,user2"` |
+| Reviewers | `--reviewer` | `--reviewer "user1"` |
+| Milestone | `--milestone` | `--milestone "v2.0"` |
+| Project | `--project` | `--project "Roadmap"` |
+**How to suggest metadata:**
+- **Labels**: infer from change type (`feat` → `enhancement`, `fix` → `bug`, `docs` → `documentation`)
+- **Assignees**: default to the current user (`@me`) unless the user specifies others
+- **Reviewers**: ask the user who should review
+**When presenting the PR for approval**, include the metadata:
+```
+Title: feat: add user login
+Labels: enhancement
+Assignees: @me
+Reviewers: (ask user)
+```
+**To update an existing PR's metadata:**
+```bash
+gh pr edit <number> --add-label "enhancement" --add-assignee "username"
+```
+### gh pr create Template
+```bash
+gh pr create --title "the title" \
+  --label "enhancement" \
+  --assignee "@me" \
+  --body "$(cat <<'EOF'
+## Summary
+<bullets>
+## Test plan
+<checklist>
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+EOF
+)"
+```
+## Quick Reference
+| Action | Command |
+|---|---|
+| Check status | `git status` |
+| Stage files | `git add <file>` |
+| Commit | `git commit -m "msg"` |
+| Push (new branch) | `git push -u origin <branch>` |
+| Push (existing) | `git push` |
+| Create PR | `gh pr create --title "..." --body "..." --label "..." --assignee "..."` |
+| Edit PR metadata | `gh pr edit <n> --add-label "..." --add-assignee "..."` |
+| Check existing PRs | `gh pr list` |
+| View PR | `gh pr view <number>` |
+## Safety Rules
+- Never force push to main/master
+- Never auto-create PRs
+- Never commit secret files (.env, credentials)
+- Never use `git add -A` — stage specific files
+- Never skip pre-commit hooks (`--no-verify`)

package/skills/amlei-resume/SKILL.md

@@ -0,0 +1,204 @@
+---
+name: amlei-resume
+description: 当用户需要写简历、改简历、投简历、换岗位重定向，或把简历导出为 A4 PDF 时使用。涵盖从素材挖掘、JD 对齐、质量评估到装配 HTML 并导出的完整流程。
+argument-hint: "[求职岗位] [意向城市] [工作年限]"
+---
+
+# amlei-resume
+
+`profile.json` 是整个 SKILL 的核心数据——用户的技能、经历、偏好、项目都记录在此。简历是基于 profile 内容，针对目标岗位裁剪组装而来的产出。
+
+**使用本 SKILL 时，必须先加载 [references/profile.md](references/profile.md)（个人资料管理流程）和 [references/projects.md](references/projects.md)（素材挖掘流程），这两份是每次操作的前置依赖。**
+
+核心原则：**不直接问"你要改哪"——通过聊项目、聊做事方式、聊自我认知，帮用户挖出他们自己都忘了的亮点，再落成简历文字。**
+
+## 开始前
+
+在开始任何操作前，先用 `todowrite` 列出当前任务的所有步骤、预期产物和注意事项，逐条推进。完成一项标记一项，确保不遗漏。
+
+### 工作流程
+
+根据用户需求选择对应流程，每步对应一个 Todo 条目。
+
+**写简历（0→1）：**
+
+1. 检查 profile
+2. 检查/导入旧简历
+3. 存 JD + 岗位调研
+4. 挖素材
+5. 共创（逐节/整篇）
+6. 评估迭代 → 不通过回到 4 或 5
+7. 用户确认保存
+8. 导出（如需）
+
+**改简历：**
+
+1. 检查 profile
+2. 存 JD + 岗位调研
+3. 挖细节/沉默亮点
+4. 迭代改写
+5. 评估迭代 → 不通过回到 3
+6. 用户确认保存
+7. 导出（如需）
+
+**换岗位重定向：**
+
+1. 读现岗简历 + 新 JD
+2. 查 profile 换贴的项目
+3. 重排模块/换关键词
+4. 评估迭代 → 不通过回到 2 或 3
+5. 用户确认保存
+
+**导出 PDF：**
+
+1. 校验 → 不通过回到装配
+2. 选主题
+3. 读组件库
+4. 装配 HTML
+5. 审查 → 不通过回到 4
+6. 套预览壳
+7. 检查分页留白 → 不均回 4 调整
+8. 交付
+
+每个步骤完成后标记 Todo，明确当前进度和下一步。
+
+### 检查个人资料
+
+使用本 SKILL 时，先运行 `profile.py path` 查看 profile 是否存在：
+
+- **不存在** → 问用户选项目级/根目录，`init` 创建并引导补充基本信息（姓名/联系方式/求职偏好/工作经历）。
+- **存在但信息不完整** → 引导用户补充缺失数据。
+
+### 通用规则
+
+**脱敏**：简历经历中涉及公司内部项目名称，一律用业务功能描述或规模定义替代（如"核心交易链路"、"支撑日均百万订单的订单系统"），严禁写入公司项目原文名称。不用"某"式占位表述。
+
+**平实表述**：每句话让读者一眼看明白你具体做了什么。写每条经历时主动问用户"你当时具体是怎么做的"，引导他说出执行细节再落笔，不替用户编造。**不解释领域常识**：标准技术名词和概念（如"Skill""YAML frontmatter""Context Engineering"）是读者已知的领域常识，不在简历中解释它是什么。要么删掉无差异化的技术列举，要么只写你做了什么/做成了什么，不写"XX是什么"。
+
+**链接限制**：仅 `self-intro` 模块可含外部链接（GitHub/作品集等），其他模块禁止出现链接。
+
+**经历定义**：
+
+**self-intro**：个人简介 + 教育背景放在同一模块（含学校、学位、专业、毕业届），不拆开。教育信息同步记录到 profile（`education add --key 学校名 --degree 学位 --major 专业 --graduation 2026届`）。
+
+**工作/实习经历**（一家公司一个条目，保持"面"的完整）：
+- **基本盘**：总体职责描述 + 核心职责模块（3-5 条 bullet），含日常运维、团队协作、零碎事项汇总、公司内获奖等——回答"你日常负责什么"
+- **高光时刻**：在该条目下嵌入 1-2 个突出成果 bullet，带量化——回答"你在这家公司干成了什么"
+- 基本盘和高光时刻在同一条目内，不拆成独立项目
+
+**项目经历**（满足 4 条件：起止时间明确 + 可量化目标 + 核心角色 + 完整闭环结果）：
+- 分公司项目和个人项目，**公司项目在前，个人项目放后**，让工作经历和项目之间形成自然衔接感。
+
+### 检查现有简历
+
+检查 `resume/{姓名}/{求职岗位}/简历.md` 是否存在：
+
+- **有简历但无 profile** → 按简历内容自动构建完整 profile（从简历分段提取基础信息、技能、项目、工作经历全量写入 profile）。**有简历且有 profile** → 问用户基于当前版本需要做哪些调整。同时检查 profile 是否有缺失（简历里有但 profile 没有的信息，问用户是否同步）。
+- **无简历** → 问用户是否有旧版简历（Word / PDF）需要导入；有则走[简历导入](#简历导入)流程（导入时自动填充 profile）；没有就从零开始。
+
+确认后查求职偏好（`preference` 无参显示）——城市、薪资、经验等作为岗位调研的锚点。再问用户要他觉得不错的目标公司 JD。
+
+### 岗位调研
+
+用户给出 JD（文字/链接/文件）后，**立即将 JD 全文写入 `resume/{姓名}/{求职岗位}/jd.md`**（一个岗位一个 JD 文件，不修改）。每次写/改前都先确认 JD 是最新的、已保存。
+
+拿到 JD 后，和用户围绕这几方面讨论，帮用户自我定位：
+
+1. **聊 JD 描述**：把 JD 里列的要求一条条跟用户过——"这个岗位要求熟练 X 技术，你之前用过吗？"、"它提到需要 Y 领域经验，你有哪些相关的？"
+2. **网络搜索岗位画像**：基于 JD 搜索该岗位的人才定位——不局限于这一家公司，而是看行业对这个岗位的普遍期望。
+3. **引导自我认知**：从 JD 的关键词出发，帮用户发现自己的对应能力和亮点。
+4. **聊现状与规划**：了解用户当前状态（城市、工作、年限），询问未来规划。
+
+### 项目材料与讨论
+
+写简历和改简历都需要挖掘用户的经历和材料。分为两个环节：
+
+1. **材料收集与探索**：用户给到网页链接、文件路径、文档等，像探索一个系统一样完整梳理整条链路，不遗漏、不预判筛选。
+2. **项目讨论**：聊项目背景、角色、难点、成果，帮用户挖出自己忘了说的亮点。
+
+详见 [references/projects.md](references/projects.md)。
+
+## 简历管理
+
+### 简历存储
+
+```
+resume/{姓名}/{求职岗位}/简历.md
+```
+
+改写简历就读这份；换岗就开新的 `{求职岗位}/` 目录存新版（原岗版本保留）。**用户没说"可以/就这样"之前，绝不写入简历文件。**
+
+### 个人资料（核心数据）
+
+`profile.json` 是全部简历操作的核心数据源。包含：
+
+| 数据 | 命令 | 用途 |
+|------|------|------|
+| 基本信息 | `profile` | 姓名/联系方式 |
+| 求职偏好 | `preference` | 城市/薪资/经验/学历等 |
+| 在投岗位 | `target` | 正在投的岗位方向 |
+| 目标公司 | `company` | 感兴趣想投的公司及 JD |
+| 工作经历 | `experience` | 工作过的公司/岗位/时间段 |
+| 能力/项目 | `add` / `update` / `find` | 跨岗位复用的技能和项目 |
+
+触发写入时机：
+- 导入旧简历时直接写（证件照/基本信息/技能/工作经历）
+- 讨论项目聊出可复用成果 → 评估 + 确认
+- 用户主动说"帮我记一下" → 评估 + 确认
+- 改完简历发现新素材 → 问用户是否同步
+
+**写入前评估（强制）：** 调用 `profile.py add` / `update` 之前，必须先派独立评估 agent 执行 [references/profile-evaluator.md](references/profile-evaluator.md)，判断该条目是否应记入 profile。评估不通过不得写入。
+
+写入流程详见 [references/profile.md](references/profile.md)。
+
+### 简历导入
+
+用户给旧简历文件（.docx / .pdf），用 markitdown 读取转 Markdown：
+
+```bash
+markitdown <文件路径> -o <输出路径.md>
+```
+
+将转换结果重排成简历格式 → 写到 `resume/{姓名}/{求职岗位}/简历.md`（自动建目录）。证件照用 `scripts/extract_avatar.py` 抽取放进同目录，MD 用 `avatar:` 引用。证件照、基本信息、技能列表直接写入个人资料 profile（不经评估 agent）。
+
+### 简历格式
+
+校验脚本会查的硬规则：
+
+| 元素 | 写法 |
+|------|------|
+| 首模块 | `# self-intro`（必须是第一个 `#`），下用 `key: value` 放 name / role / gender / location / phone / email / avatar / links 等。多值字段（links、education）用缩进子项：<br>`links:`<br>`- GitHub: url`<br>`education:`<br>`- 学校: xxx`<br>`- 专业: xxx` |
+| 模块 | `# 模块名`（出现顺序 = 简历模块顺序） |
+| 简介 | 模块下纯文本段 |
+| 标签 | 模块下「标签, 标签」单行（研究兴趣 / 方向） |
+| 经历 | `## 机构 \| 角色/方向`（无 `\|` 则只有机构名） |
+| 经历日期 | `date: 2024.07 — 2025.03` |
+| 经历补充 | `meta: GPA 3.9/4.0 · 排名 1/60`（关键数字用 `**`） |
+| 经历要点 | `- 成就（STAR + 量化）` |
+| 技能 | `- 类别: 值` 或 `类别: A · B · C`。类别须按专业领域拆分（如 AI/Agent、编程语言、框架、数据存储、工程化各独立一类），不能跨域混放 |
+
+`name:` 必填；`avatar:` 给照片相对路径；`links` 放可线上展示自己的链接，如个人博客、飞书文档、作品集等（key: value）。完整范例：[sample-resume.md](assets/sample-resume.md)。
+
+## 质量保障
+
+### 简历评估（强制）
+
+写/改完成简历后（`resume/{姓名}/{求职岗位}/简历.md`），**必须执行** [references/resume-evaluator.md](references/resume-evaluator.md) 的 6 维度评估流程，根据结果迭代修改直到所有维度通过。用户确认通过后才进入导出。
+
+### 易错点
+
+- **残留 `{{占位符}}`**：组件模板占位符必须全替换（校验兜底）。
+- **`# self-intro` 必须是首个 `#`**，渲染成 Header 而非 SectionHead。
+- **`data-stick="1"` 别漏**：SectionHead 必带。
+- **联系方式按实际字段拼**：没有的字段连同分隔符一起删。
+- **`avatar:` 有就 `<img>`**：没照片用 icons.md 占位 SVG。
+- **整篇只用所选主题的组件**，不从别的主题借。
+- **标题层级只用 `#`/`##`**。
+
+## 预览与导出
+
+用户要求导出 PDF 时执行。详细流程见 [references/export.md](references/export.md)。
+
+## 添加新主题
+
+新主题可直接编写或从参考简历 HTML 转换（规范见 [references/themes/theme-index.md](references/themes/theme-index.md) 末尾）。写完用 `assets/sample-resume.md` 渲染 → 校验 → 套壳 → 浏览器打开预览核对，确认后登记到 theme-index。