Communitygithub.com

yanliudesign/job-description-skill

Claude skill that reads a job description and hands back an HTML report — match score, resume tailor, interview predictor, and a should-I-apply verdict.

¿Qué es job-description-skill?

job-description-skill is a Claude Code agent skill that claude skill that reads a job description and hands back an HTML report — match score, resume tailor, interview predictor, and a should-I-apply verdict.

Compatible conClaude CodeCodex CLI~Cursor
npx skills add yanliudesign/job-description-skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Job Description Skill

把一份 JD 从「招聘话术」翻译成「你能用的求职情报」,一次性产出一份单文件 HTML Offer Strategy Report,自动在浏览器打开。

下游可一键接 Resume Skill(拿着 Gap / Tailor 结果继续打磨简历)和 BQ Skill(拿着预测题目去练故事),形成完整求职链路。


整个 skill 只有 3 步

Step 1 · 贴 JD

开场只说一句话:

"把你想分析的 Job Description 链接或全文 贴给我。链接抓不到内容就直接粘贴 JD 文本。"

收到后:

  • 链接 → 尝试抓取;抓不到 → 让用户粘全文,别根据公司名瞎猜 JD
  • 同时确认 公司名 / 岗位 / Level(JD 没明写就追问一次)。
  • 先查 jd-bank/_index.md — 同公司同岗位半年内分析过,告诉用户"上次解码过,要不要直接复用"。

Step 2 · 给简历或 LinkedIn

三选一,明牌列出来:

"为了算匹配度 / 出 Gap / 预测面试题,需要了解你。三选一:

  • 🅰️ 上传 / 粘贴简历全文(PDF / Word / 文本都行)— 强烈推荐,结果最准
  • 🅱️ 粘贴你的 LinkedIn 全文(不是只给 URL,要全文)
  • 🅲️ 简略介绍一下自己(还没有简历的情况)"

如果用户选 🅲️,一次问一个问题,别一次列 6 个:当前 Title + 年限 → 行业 → 近 2-3 段经历(公司 + 负责什么 + 1 个最亮成果)→ 最强 1-2 个技能 → 想往哪个方向走。

⚠️ 选 🅲️ 路径的副作用:报告里所有"匹配度 / Tailor / Gap"结论都要标 "基于用户自述,未经简历事实校验",并强烈建议跑完后去 Resume Skill 做一份正式简历再回头精修。

Step 3 · 生成 HTML 并自动打开

收齐 JD + 简历后,不要再分别请示用户跑 Decode / Match / Predict / Should I Apply — 一口气在后台跑完 5 条流程(prompts/ 下的 5 份文件),把结果直接组装成一份 HTML Offer Strategy Report:

  1. 在内存里跑 Decode → Match → Predict → Should I Apply(Tailor(简历定向调整) 只取关键 diff,简历整体打磨交给 Resume Skill)。
  2. frameworks/offer-strategy-report.md 的规格 + examples/offer-strategy-template.html 的骨架组装一份 10 节报告(TL;DR · 关键指标 · 1-10)。
    • 品牌 footer 是强制项,不是装饰。 报告结尾必须原样包含 <footer> 里的 JD SKILL. brand mark + Created by Dreameryanyan 副标题 + LinkedIn / X / 小红书三个社交按钮(含对应 CSS:.brand-block / .brand-mark / .socials / .foot-meta)。这是作者署名,无论报告多长、数据多少都不许删或简化。生成时直接从 frameworks/offer-strategy-report.md 末尾「📌 强制 Footer 区块」整段抄过去。
  3. 写到 ~/Desktop/Claude skills/offer-strategy-<company>-<role>-<YYYYMM>.html
    • 写完后跑两道自检,任一道失败 = 报告不合格,必须重写这几块再继续(不要跳过校验直接宣称“已生成”):
      • Footer 自检 — 文件里必须能搜到 Dreameryanyanbrand-markyanliudreamerxiaohongshu 四个关键词,缺任一 = footer 被丢了。
      • 双语自检<html lang="en"> 必须默认为 en(不允许 zh / zh-CN),且 grep -c 'data-lang="en"'grep -c 'data-lang="zh"' 数量相等且 ≥ 80。少于 80 = 模型又把内文写成了单语,已知失败模式,参见铁律四。双语 span 对的写法与适用范围见 frameworks/offer-strategy-report.md
  4. 自动打开:跑 open "<完整路径>"(macOS)/ xdg-open (Linux) / start (Windows),让 HTML 直接在浏览器弹出来。
  5. 同步 jd-bank/:按 jd-bank/_jd-template.md 写一份 <slug>.md,更新 jd-bank/_index.md,文件末尾加一行 > 📊 HTML 报告:~/Desktop/Claude skills/offer-strategy-<slug>.html

最后一句收尾:

"报告已生成并在浏览器打开 ✅ · 📊 ~/Desktop/Claude skills/offer-strategy-<slug>.html · 内置 Export PDFExport Markdown 两个按钮 · 这份 JD 已存进 jd-bank/,下次提到自动复用

下一步:

  • 决定投 → 交给 Resume Skill 做整体简历打磨
  • 准备 Behavior 题 → 转 BQ Skill 挖故事
  • 看下一份 JD → 直接贴过来"

四条铁律(内部 5 条流程跑的时候都要守)

铁律一 · 先解码,再做任何事。 跑 Match / Tailor / Predict 之前必须先在内存里跑完 JD Decoder 的 5 图层(招聘经理真实需求 / Must Have / Nice to Have / Hidden Signals / Level 判断)。直接拿原始 JD 去算匹配度,是在跟「招聘话术」对齐,不是跟「招聘经理真实需求」对齐 — 这是 90% 求职工具最大的盲区。

铁律二 · 不替用户编简历内容、不编公司情报。

  • Resume Tailor 只能重新组织 / 突出 / 翻译用户简历里已有的事实,不能凭空捣造成就、数字、职责。
  • 公司文化、团队信号只能从 JD 文本 + 用户提供的信息推断;不要装作知道某公司内部情况。所有推断都标“我从 ___ 推断”。
  • 报告 §1 公司背景 / §2 本职位产品分析 用到的公司画像、产品节点等若做了 web 调研,标明来源;查不到就标 [需用户补充]别编

铁律三 · 数据没齐就不要硬出报告。 JD 缺关键内容 / 用户没给简历或自述 → 先把缺的要齐,别硬跑。报告底部的“假设说明”章节必须显式列出所有假设(薪资底线 / visa / on-site 接受度 / Title 接受度 等),并写明“任一不对告诉我重新生成”。

铁律四 · 报告必须真双语,不是代码已插了切换按钮就算数。 模板 .report-tools 里的 EN / 中文 切换按钮靠 CSS 根据 <html lang> 切显 [data-lang="en"] / [data-lang="zh"] 两个 span。若你把正文写成单语(全中文或混排),按钮看起来能点但切什么都不变 — 这比报告内容自身错更严重,因为它伪造了交付完整度。

  • 默认 <html lang="en">。EN 在前、ZH 在后:<span data-lang="en">English</span><span data-lang="zh">中文</span>
  • 每一句用户可见拷贝都要双胞胎:Verdict / Assumptions / Must Have 卡 / Matrix 三列 / Gap / 不投理由 + HM probe / Top 10 题 / 6 周时间线 / DM 模板…具体范围及例子见 frameworks/offer-strategy-report.md
  • 注释 / 占位符 / 纯数字 / 专有名词不用双胞胎。
  • 自检 ② 会卡住单语报告(data-lang="en"data-lang="zh" 数量不相等或总数 < 80)。

内部流程(用户看不到,由 Step 3 调用)

流程干什么Prompt 文件
1 · Decode5 图层拆解 JD 真实意图prompts/jd-decoder.md
2 · Match匹配度(0.6/0.2/0.2 加权)+ Must Have 逐条命中 + Gap 三档prompts/match-score.md
3 · Tailor简历 diff(仅取关键改写片段进报告,整体打磨交 Resume Skill)prompts/resume-tailor.md
4 · PredictTop 20 面试题(报告里只放 Top 10,导流 BQ Skill)prompts/interview-predictor.md
5 · Should I Apply五件套决策(⭐ / 值得投 / 不值得投 / 拿面概率 / 下一步)prompts/should-i-apply.md

这几个步骤在 Step 3 里被调用一次,结果全部塞进同一份 HTML 报告。 用户看不到"现在在跑匹配步"这种内部状态。

如果用户明确只想要某一条流程("只解码不要别的" / "只算匹配度")→ 跳过 Step 3 的报告生成,直接吐这一条流程的纯文本结果。这是例外路径,不是默认。


JD Bank

  • 位置:本 skill 目录下 jd-bank/,每份分析过的 JD 一个 .md
  • 文件名:<公司缩写>-<岗位slug>-<YYYYMM>.md,如 openai-product-designer-202606.md
  • frontmatter 必填:company / role / level / source_url / decoded_at / status(decoded / matched / tailored / applied / interview / closed)。
  • jd-bank/_index.md 是反查表:按公司、按岗位类型、按状态分组。每次 Step 3 生成报告都要同步 _index.md
  • 用户回头说"上次那个 ___"时,先查 index,别让用户重新粘 JD。

与 Resume Skill / BQ Skill 的衔接

这个 skill 不替代另外两个:

  • Resume Skill 负责把一份简历做到「整体优秀 + 个人故事一致」。JD Skill 报告里的 Tailor diff 只做针对单个 JD 的定向调整 — 告诉用户"要做整体优化去 Resume Skill"。
  • BQ Skill 负责挖掘 / 结构化 / 维护故事库。JD Skill 报告 §9 只给"会被问什么" — 告诉用户"用 BQ Skill 把这些题挖成故事"。

三者形成的用户路径:

看到 Dream Job
   ↓
JD Skill:贴 JD → 给简历 → HTML 报告自动弹出
   ↓(决定投)
Resume Skill:整体简历打磨
   ↓(拿到面试)
BQ Skill:挖故事 / 模拟面试
   ↓
拿 Offer

参考文件(按需读取,别一次全加载)

Prompts(5 条内部流程的执行脚本)

Frameworks(知识词典 + 报告规格)

Examples

JD Bank(情报库)

Skills relacionados