job-article
itwanger/toBeBetterJavaer · Agent Skill
Generates job, internship, and career articles in the style of 'Er Ge', focusing on job search tips, salaries, and career paths.
Jump to install ↓Install options
The review-first prompt is selected by default. You can switch to a direct command.
Copy the prompt, paste it into Claude, Codex, or another assistant, and it will review the skill page and install it.
I'd like to install this Claude Code skill: https://github.com/itwanger/toBeBetterJavaer/tree/master/.claude/skills/job-article Please review the SKILL.md file, verify the skill is legitimate, then copy the skill folder into .claude/skills/ of my project.
A direct command skips the review — inspect the source first.
npx skills add https://github.com/itwanger/toBeBetterJavaer/tree/master/.claude/skills/job-article
Read SKILL.md and any companion files before deciding whether to install. Click a file to preview it.
SKILL.md contents
Original author text · read-only求职/校招/职场类文章生成工作流
⚠️ 强制检查项(每次执行前必读)
在开始写作前,必须阅读并承诺遵守以下强制要求:
| 检查项 | 要求 | 检查方法 |
|--------|------|----------|
| 标点符号 | 正文使用中文标点,减少使用双引号 | 生成后只检查正文,排除代码、URL、YAML、命令 |
| 标题风格 | 60字内,口语化,参考 biaoti.md 的模式 | 正文写完后读 biaoti.md,生成5个候选标题 |
| 前言结构 | 前3段内完成"冲突-结果-收益"三连 | 检查前三段内容 |
| 二级标题 | 格式为"## 01、标题" | 检查所有二级标题 |
| 截图占位符 | 每个核心章节至少1个,包含截图目标和关键词 | 检查各章节 |
| ending | 结尾标题 ## ending,不低于200字的情绪升华 | 检查结尾 |
| 少用你 | 避免使用"你",多使用"我们" | 检查全文 |
| AI味词汇 | 避免使用"值得注意的是""此外""标志着""链路""你想啊"等 | 检查全文 |
| 黑话 | 避免使用"赋能""抓手""闭环""打通"等 | 检查全文 |
| 数据溯源 | 涉及准确数据(薪资、offer数、公司信息等)必须标注来源,禁止凭空编造 | 检查所有数据引用 |
| 球友隐私 | 球友信息脱敏,不透露真实姓名、学校全称等敏感信息 | 检查全文 |
未完成以上检查的文章,不得交付。
---
环境声明(每次执行前必读)
执行本工作流前,先运行以下命令获取当前真实日期:
date "+%Y年%m月%d日"
后续所有涉及日期的操作必须基于这个日期:联网搜索关键词带上当前年月,文章 date 字段使用当前实际日期,正文时间描述基于当前日期。
---
概述
根据指定选题或当前求职季热点,按照二哥的写作风格完成求职/校招/面试/职场类文章撰写。定位是Java求职博主+知识星球球友服务。
核心内容方向:秋招春招实操建议、公司薪资爆料与学习路线、面经八股拆解、求职心态与球友真实故事。
目录结构
job-article/
├── SKILL.md # 本文件,工作流和写作规范
├── biaoti.md # 标题风格参考,高打开率标题合集
├── sucai.md # 本次写作的参考素材(临时),用户提供的球友故事、薪资数据、面经等
├── references/ # 历史文章素材,学习写作风格用
│ ├── 25-26jie-quanshuo.md # 秋招建议类风格参考
│ ├── gongsi-xinzi-xuexiluxian.md # 公司薪资+学习路线类风格参考
│ ├── leijun-jianli.md # 面经八股类风格参考
│ └── offer-changbiaoti.md # 求职观察类风格参考
└── scripts/
└── check_body_length.py # 正文字数检查脚本
工作模式
用户通过提示词或 sucai.md 指定选题,直接进入撰写流程。
工作流程
步骤1:检查素材
./sucai.md(默认主素材)
精读素材库中的内容,消化吸收。读取后提取关键信息:球友故事、薪资数据、面试题目、求职经历、截图等,作为正文素材池。尤其是截图和球友对话截图,可以直接搬运到正文中,减少改稿成本。
步骤2:搜集资料
用联网搜索(如 web_search)搜索该选题的相关资料,关键词带上当前日期,确保信息时效性。
根据文章风格类型,搜索方向有所不同:
秋招建议类:搜索当前招聘季的时间节点、各大厂招聘进度、HC开放情况。
公司薪资类:搜索目标公司的最新校招/社招薪资数据、公司近期动态(融资、营收、市场地位)、招聘JD要求。
面经八股类:搜索相关技术知识点的最新变化、面试热门考点趋势。
求职观察类:搜索当前就业市场整体情况、求职者普遍痛点。
补充要求:
- 薪资数据标注来源和时间,区分"网传"和"已确认"。
- 公司信息(营收、市场份额等)尽量追溯官方来源。
- 面试题目的解析要准确,不要似是而非。
步骤3:整理素材清单(先于写作)
写正文前,先整理"素材清单",根据风格类型不同,包含不同内容:
秋招建议类:列出要给的建议点、支撑每个建议的球友案例或数据。
公司薪资类:列出薪资数据来源、公司背景信息、学习路线的模块划分。
面经八股类:列出面试题目清单、每道题的解析思路、代码示例来源。
求职观察类:列出核心观点、支撑观点的球友故事、情感共鸣点。
如果素材不足以支撑某个板块,必须在清单中标记"素材不足",对应正文段落需要降级处理或换方向。
步骤3.5:文章风格选择
使用 AskUserQuestion 工具询问用户选择 ./references/ 目录中的风格类型:
- 秋招建议类:给求职者的实操建议,带球友案例和鼓励,语气像老学长聊天(参考:
references/25-26jie-quanshuo.md) - 公司薪资+学习路线类:爆料薪资数据引发关注,然后给出项目学习路线,实用性强(参考:
references/gongsi-xinzi-xuexiluxian.md) - 面经八股类:名人趣事或热点开头吸引眼球,然后引入面试题解析,知识密度高(参考:
references/leijun-jianli.md) - 求职观察类:分享求职心态洞察,大量球友真实故事,情绪共鸣强烈(参考:
references/offer-changbiaoti.md)
重要说明:
1. 风格参考 ≠ 内容照搬:参考选定的文章学习二哥的语气、节奏、表达方式,但内容必须大胆创新,不能照搬参考文章的结构或素材
2. 球友故事可以改编:可以基于真实球友经历改编、合并、虚构细节,但核心经历要有可信度
3. 开头和结尾要创新:不要老生常谈,不要每次都写类似的套路,根据内容特点设计有新意的开头和结尾
4. 保持二哥的特色:口语化、有温度、像朋友聊天,避免AI味词汇和黑话
步骤4:撰写文章
文件格式为 Markdown,正文目标字数 4500 字(允许范围 4000-5500)。
撰写时按照步骤3.5用户选择的风格类型,参考对应文章学习二哥的写作风格,并结合 ./sucai.md 的素材。
重要:初稿写作时直接瞄准 4500 字,留出余量,避免反复检查补字。
字数检查与调整流程:
1. 初稿完成后,使用 ./scripts/check_body_length.py 检查字数
2. 如果字数在 4000-5500 之间:达标,直接进入步骤5落盘输出
3. 如果字数 < 4000:不得交付,必须一次性扩展到 4500 字以上(不是刚好补到 4000 字卡线)。使用 AskUserQuestion 工具提供2-3个扩展方向让用户选择,然后一次性补充完整段落或新章节,扩展后再检查一次字数。禁止每次只加几十个字反复检查
4. 如果字数 > 5500:内容过长,需要精简。删减重复论述、合并相似段落、砍掉价值不高的章节,直到回落到合理区间
文章头部模板:
---
title: # 步骤5.5生成标题后回填
shortTitle: # 步骤5.5生成标题后回填
description: 文章描述
tag:
- 求职
category:
- 求职
author: 沉默王二
date: # 使用 date 命令获取的实际日期,格式 YYYY-MM-DD
---
步骤5:落盘输出
文件命名用文章主题关键词,保存到 docs/src/sidebar/itwanger/qiuzhi/ 目录(相对仓库根目录)。此时 frontmatter 的 title/shortTitle 可先留空。
步骤5.5:生成标题
正文定稿后,读取 ./biaoti.md,分析其中高打开率标题的共同特点(口语化、有数据、有情绪、有悬念、60字以内),结合本次文章主题生成5个候选标题,让用户选择。选定后回填 frontmatter 的 title 和 shortTitle 字段。
步骤6:交付前检查(强制执行)
文章完成后,必须逐项检查以下清单,未完成的必须修改后再交付:
- [ ] 正文使用中文标点符号(少用双引号,除非必要)
- [ ] 少用你,用我们(和读者拉近关系)
- [ ] 标点检查仅针对正文,排除代码块、行内代码、URL、YAML frontmatter、命令行
- [ ] 前言在前3段内完成"冲突-结果-收益"三连
- [ ] 二级标题格式为"## 01、标题"、"## 02、标题"
- [ ] 每个核心章节(## 01及之后)至少1个截图占位符
- [ ] 每个截图占位符包含"截图目标"和"关键词"
- [ ] 结尾用## ending,有情绪升华(不低于200字)
- [ ] 正文长度4000-5500字,不包括代码(使用
./scripts/check_body_length.py检查字数) - [ ] 薪资数据标注来源和时间,球友信息脱敏
- [ ] 面试题解析准确,代码无语法错误
- [ ] 避免 AI 味词汇(值得注意的是、此外、标志、链路、收敛着等)
- [ ] 避免互联网黑话(赋能、抓手、闭环、打通等)
写作原则
标题风格
详见 ./biaoti.md。文章正文写完后,读取该文件,参考其中的高打开率标题风格,生成5个候选标题供用户选择。
语气和称呼
用"大家"、"我们"、"小伙伴"、"球友"和读者拉近关系,保持对话感,尽量少用"你"。语气像老朋友聊求职,不是就业指导中心的老师,要有温度、有态度、有真实感。
文章开头套路
开头要能抓住读者注意力,但不要标题党。求职类文章的开头特别讲究代入感,要让读者觉得"说的就是我"。
各风格推荐开头方式:
秋招建议类:用一个经典引用或金句切入,然后对比"已上岸"和"还在奋战"的两种状态,制造紧迫感但不贩卖焦虑。参考"杜牧阿房宫赋"的引用方式。
公司薪资类:直接抛出一个让人震惊的薪资数据,用数字冲击力抓住注意力,比如"base 30k""比某厂高了8k"。然后快速交代背景。
面经八股类:用名人轶事、热门梗或搞笑场景开头,让读者觉得有趣才往下读。比如雷军简历的方式,用调侃拉近距离。
求职观察类:用一个反常识的观点或读者普遍困惑的问题切入,比如"凡是给offer的公司,面试时基本不问技术细节"。
前言冲击力(强制)
前言必须在前3段内完成"冲突-结果-收益"三连:
- 冲突:明确一个求职中的真实痛点或反常识现象。
- 结果:提前给出一句高价值结论(但不剧透全部细节)。
- 收益:告诉读者继续读下去能拿到什么(方法、避坑点、面试真题、薪资参考)。
正文结构
用二级标题分块,格式为"## 01、标题"、"## 02、标题"。
二级标题下可以用三级标题细分。三级标题格式为"### 三级xxx"。三级标题下可以有四级标题,但不强制,视内容需要而定。
各风格的正文结构建议:
秋招建议类:每个二级标题是一条建议,先讲道理再举球友案例佐证,穿插个人感悟。二级标题之间有递进感,从基础建议到心态建议。
公司薪资类:先花1-2个章节介绍公司和薪资,再用3-4个章节给出学习路线。学习路线按阶段划分,每阶段有明确目标和产出。最后贴喜报鼓励。
面经八股类:开头用1个章节做引子(名人/热点),然后每个二级标题是一道面试题。面试题解析要深入浅出,有代码有图有类比。最后附参考链接。
求职观察类:前1-2个章节提出现象和观点,然后用球友故事做主体内容。故事要有细节、有时间线、有情感。最后回扣主题,升华情绪。
Case 创意
球友的真实故事是最好的素材。可以改编、合并、虚构细节,但核心经历要可信。
好的Case包括:逆袭上岸的故事、意外拿到大厂offer的经历、简历迭代前后的对比、薪资谈判的技巧、实习转正的心路历程。
涉及项目的部分,可以推荐二哥的开源项目(教程需要登录,可以直接 CDP 打开我有session的浏览器):
- 技术派(paicoding.com):Spring Boot 社区项目:https://paicoding.com/column/6/1
- 派聪明 RAG:教程地址:https://paicoding.com/column/10/1
- PmHub:微服务项目管理系统,教程地址 https://paicoding.com/column/9/1
- PaiFlow:工作流引擎项目,教程地址 https://paicoding.com/column/13/1
- PaiAgent:PaiFlow的 Vibe Coding 版本,教程地址 https://paicoding.com/column/14/1
段落优先原则(强制)
正文内容优先使用段落式写法,用完整的句子和自然的过渡来表达观点。能用一段话说清楚的事情,就不要拆成列表。
核心要求:
- 段落式写法是默认选择,列表是例外情况
- 用自然的句子连接观点,而不是用列表强行分段
- 保持阅读的连贯性,让文章像聊天一样流畅
仅限以下情况使用列表:
- 薪资数据对比(多个offer的薪资包明细)
- 面试题目清单
- 学习路线的阶段划分和具体任务
- 简历模板的核心职责条目
反面示例(禁止):
错误:
秋招要注意以下几点:
- 简历要迭代
- 心态要稳
- 不要放弃
正确:
秋招这件事,最重要的就是简历要反复迭代。很多人觉得自己写了一版简历就完事了,但从我改过的3000多份简历来看,80%的球友第一版简历都不够看。心态也得稳住,不要看到别人拿了offer就慌了手脚,更不要轻易放弃秋招去等春招。
常用表达
自然融入这些口语化表达:"说真的"、"讲真"、"真心话"、"有一说一"、"这一点至关重要"、"强,实在是太强了"、"怎么样,是不是xxx?"、"啧啧啧"、"冲!"(适度使用)。
求职类特色表达:"简历都给我往死里迭代"、"人生比拼的不只是实力,还有运气"、"上岸了年薪几十万当然爽"、"贴个喜报鼓励一下大家"、"共勉一下"。
文章结尾套路(重要)
用## ending作为结尾标题,一句话总结核心观点。结尾要给读者提供情绪价值,表达更深层的价值观和人生思考。这种段落能让读者从获取信息变成产生共鸣。
用短句和换行制造节奏感。不要写长段落,每句话单独一行或两三句一段。短促的节奏更有力量感。
用具体的生活场景代替抽象的道理。具体的画面比抽象的道理更打动人。
可以用对比制造张力,但避免连续二元排比和模板化口号。重点是具体场景里的真实反差,而不是套句式。
金句用加粗框【xxx】起来。一段情绪升华最多一句金句,金句要短,要有记忆点。
求职类结尾方向:
- 努力的人不应该被辜负,但也要接受暂时的运气不好
- 求职焦虑背后是对未来生活的期待,这很正常
- 人生不只是一次秋招,路还长,别急
- 从校园到社会的跨越,每个人都会经历迷茫
- 学历、技能、运气都很重要,但坚持比什么都重要
- 走在正确的道路上,我们从未相隔太远
人性化表达规范
确保文章读起来像真人写的,避免 AI 生成的机械感。
核心原则
打破公式结构,避免二元对比和戏剧性分段。变化节奏,混合句子长度,两项优于三项。信任读者,直接陈述事实,跳过软化和辩解。
句式和节奏
长短句交替使用,不要连续出现结构相同的句子。比如不要连续三句都是"xxx是xxx"这种判断句。可以用反问、感叹、设问来调节节奏。段落结尾要多样化,不要每段都以总结句收尾。
必须避免的 AI 味词汇
总结性套话:值得注意的是、需要指出的是、综上所述、由此可见、不难发现、此外、与此同时。
夸大意义的词:标志着、见证了、是……的体现/证明/提醒、凸显/强调/彰显了其重要性、为……奠定基础、不可磨灭的印记。
宣传性语言:充满活力的、丰富的(比喻)、深刻的、著名的、令人叹为观止的、开创性的、坐落于。
模糊归因:行业报告显示、观察者指出、专家认为、一些批评者认为、多个来源表明。
互联网黑话:赋能、抓手、闭环、打通、沉淀、对齐、拉通、链路,除非是讽刺语境。
必须避免的 AI 句式
否定式排比:"不仅……而且……"、"这不仅仅是……而是……"被严重过度使用,直接删除。
三段式法则:不要强行把想法分成三组来显得全面,两项或四项更自然。
-ing 结尾的肤浅分析:删除"……,确保了……"、"……,体现了……"、"……,彰显了……"这类句尾。
过度限定:删除"可以说"、"在某种程度上"、"从某种意义上讲"这类软化词。
通用积极结论:删除"未来可期"、"前景光明"、"值得期待"这类空洞结尾。
特色元素
球友故事模块
求职类文章的核心竞争力就是真实的球友故事。好的球友故事需要:
- 有具体的时间点(不要模糊说"某天")
- 有转折(从困难到突破,或者从迷茫到清醒)
- 有细节(面试时被问到什么、简历改了几版、等offer时的心情)
- 有对话感(可以用引用框展示球友原话或聊天记录)
球友对话引用格式:
> 球友:"二哥,我感觉秋招来不及了,要不等春招吧?"
用脱敏方式提及球友,比如"一位球友"、"前面拿到阿里offer的那个球友"、"星球里一位985硕士的球友"。
薪资数据模块
薪资是求职类文章的流量密码。展示薪资数据时注意:
- 列表形式展示多个offer对比,每条包含:学历、岗位、base、总包
- 标注来源("从show哥那里统计"、"球友反馈"、"Java面试指南中")
- 加上二哥的点评("真的非常香"、"很有诚意的SP"、"不满意拒了")
简历/项目包装环节
如果文章涉及实战项目或学习路线,可以加一个如何写到简历上的模块。
项目名称
项目简介:xxx
技术栈:xxx
核心职责(5条)
- xxxx 公式:用技术栈解决了什么问题、实现了哪些业务,有哪些量化数据
知识星球引流(自然融入)
在合适的地方自然提及知识星球和相关资源,不要硬广:
- 提到球友故事时顺带一句"星球里的一位球友"
- 提到简历修改时说"从我改过的3000多份简历来看"
- 提到薪资数据时说"我也从show哥那里统计了一波,放在了Java面试指南中"
- 提到面经时说"完整面经我放在了帖子里"
截图与配图占位符(强制)
文章中需要配图的地方,必须用占位符标注出来,方便后续插入。如果 ./sucai.md 中有相关截图,直接搬运过来即可。终稿必须包含"截图占位符 + 关键信息关键词",并满足:
- 每个核心章节(
## 01及之后)至少1个截图占位符。 - 每个占位符必须写清"截图目标"和"关键词",方便后续检索与取证。
- 没有截图占位符的章节视为未完成,不允许交付。
截图/图片占位格式(固定模板):
【此处插入<截图名称>:截图目标:<这张图要证明什么>;关键词:<关键词1>、<关键词2>、<关键词3>;建议位置:<聊天记录/薪资截图/offer截图/网页/IDE>】
示例:
【此处插入球友offer截图:截图目标:证明影石薪资确实很高;关键词:影石、30k、offer;建议位置:聊天记录截图】
【此处插入投递记录表截图:截图目标:展示规范的求职记录方法;关键词:投递表格、流程状态、offer跟踪;建议位置:Excel表格截图】
禁止事项
不要用"首先、其次、最后"八股结构,这种写法太死板。不要过度使用emoji,偶尔用一两个可以。不要写超过5行的长段落,适时换行保持阅读节奏。不要用"让我们"、"我们来看看"这种翻译腔。不要贩卖焦虑,可以指出现实但要给出路径。不要居高临下地说教,二哥的定位是和读者一起成长的朋友。严禁滥用列表,具体规则见"写作原则 > 段落优先原则"。不要在求职建议里加太多无用的心灵鸡汤,读者要的是能落地的东西。