公司简报
将公司名称或URL转化为一份深入、有来源、设计精美的PDF文件,告诉读者他们需要的一切:无论是参加面试、谈薪资、向客户提案,还是首次与一个新品牌合作,这份简报都能提供所需信息——公司是什么、经营状况如何、谁在管理、在那里工作是什么感觉、品牌和营销如何运作、竞争对手是谁,以及如何与该公司沟通。PDF使用公司自己的色彩和字体,因此看起来就像属于他们自己。
使用方法
/company-brief <公司名称或URL> [for <角色>] [brand kit] [shareable]
示例:/company-brief linear.app、/company-brief Figma for Senior Brand Designer、/company-brief patagonia.com brand kit、/company-brief Notion shareable。纯文本请求也能工作:例如“帮我做一份关于Notion的公司简报,我要面试”或“我们刚签下Oatly作为客户,我需要快速了解他们的品牌。”
- 公司:URL可以确定身份。仅有名称可能无法确定(第1步)。
- for <角色>:将招聘、需了解的人员以及面试准备重点聚焦在该角色及其团队上。如果没有提供,默认聚焦于设计、品牌、营销和创意领导岗位,或取决于提问者的背景。
- 个人模式(默认):为提问者定制。利用你了解的关于他们的信息(记忆、历史对话、本次对话、附带的简历或作品集)来撰写“你的角度”、提案以及“适合度”。如果对方手头有offer,则添加“签约前须知”。如果你对他们一无所知,则泛泛地撰写这些部分,并在回复中提供定制化选项。
- 品牌工作模式(“brand kit”,或对方表示他们正在为品牌设计、向品牌提案、或作为设计师、策略师、内部或代理伙伴开始与品牌合作):品牌标识和品牌资料包部分将得到最细致的处理,资料包包括完整的资产列表和“向客户索要”提示(参见 references/brand-extraction.md,第4节)。在第五部分,“面试准备”变为“启动准备”(品牌团队会期待什么、要带什么、可能的问题),“要问的问题”是针对品牌团队的,并且放弃“适合度”和“签约前须知”部分。保留招聘内容,精简为简短段落。
- 可共享模式(“shareable”、“for a friend”、“to send to someone”):不包含任何关于提问者的信息。没有“为XX准备”标签,没有适合度评分,没有签约前须知。第五部分变为“如何与他们沟通”,“你的角度”变为“有效的沟通角度”。
除非公司身份确实存在歧义,否则不要停下来提问。在第一次回复中就开始:用一句话说明你在做什么,列出任务清单,然后进行研究。
技能文件
以下路径使用 ${CLAUDE_SKILL_DIR}。如果该文本未在您运行的环境中替换为实际路径,请使用 find / -name brief-template.html -path '*company-brief*' 2>/dev/null | head -1 查找文件夹,并在每个命令中使用其绝对路径(shell变量可能在命令之间不会持久)。
| 文件 | 用途 |
|---|---|
assets/brief.css | 基础样式表。复制它;不要编辑它。 |
assets/brief-template.html | 整个简报的骨架,包含 {{placeholders}} |
scripts/fonts.py | 从Fontsource安装免费字体并打印 <link> 标签 |
scripts/tokens.py | 将品牌颜色转换为token <style> 块,包含对比度修复 |
scripts/render.cjs | 使用Node Playwright渲染PDF,并审计字体、对比度、占位符 |
scripts/render.py | 功能相同(Python实现),回退到Chrome CLI,然后是WeasyPrint |
scripts/audit.js | 两个渲染器在页面内部运行的审计脚本 |
scripts/contact_sheet.py | 为版面检查生成每页一张缩略图 |
references/research-playbook.md | 每个部分应该去哪里查找,以及高效的顺序 |
references/brand-extraction.md | 从真实网站获取颜色、字体和Logo描述 |
references/components.md | 每个组件的标记、部分顺序、写作规则 |
硬性规则
- 首先去歧义。 许多公司共享名称,融资数据库和招聘网站经常合并它们。确认每个财务和招聘事实属于正确的实体(相同的域名、创始人、总部)。如果存在冲突,在摘要开头用一个名称检查标注说明。
- 每个数字都有来源、日期和置信度标签:
已验证(主要来源:备案文件、公司自己的网站或招聘页面)、已报道(可信的新闻媒体)、公司声称(他们的营销材料)、估计(第三方或你的推断;说明依据)、未知(已搜索,未找到;说明搜索范围)。 - 边研究边将发现写入
research-notes.md。 在长时间研究中,搜索结果会从上下文中清除。任何未写下的内容都会丢失。 - 时效性:使用今天的日期;在新闻搜索中加入年份;标记任何超过18个月的信息为过时。
- 人员:仅限面向公众的领导者和与角色相关的人员,并且仅限公开的专业信息。不得包含个人联系方式、家庭住址、家庭成员或人物照片。
- 品牌资产是链接,绝非复制。 用语言描述Logo,并链接到品牌自己的Logo文件和指南。不要重新绘制、描摹、嵌入或下载Logo、吉祥物、字体或广告图片到简报或工作文件夹中。优先使用品牌的新闻资料包、品牌门户或指南,而非第三方Logo网站,注明来源,通过打开文件确认其格式,并链接管理这些文件的使用条款。色板、字样样本和抽象的品牌色图案是可以的。
- 引用:员工评价摘录不超过25个词,总共不超过4条,注明平台和日期。总结文章内容,不要粘贴原文。
- 标注为独立的:封面注明“独立研究简报。未与<公司>关联或获得其认可。”
- 用一行说明缺失了什么,而不是默默地删除某个部分。
- 永远不要声称你未进行的检查(例如“本简报仅审阅了Glassdoor”)。
- 可共享简报 不包含任何关于提问者的私人信息,即使你知道这些信息。
工作流程
创建此任务列表,完成一项后勾选一项:
- 识别公司并检查名称冲突
- 设置工作目录和笔记文件
- 阅读公司自己的网站和招聘页面
- 并行批量研究其他所有内容
- 提取品牌颜色和字体;构建token和字体
- 构建品牌资料包:Logo文件、指南、字体、颜色规格
- 综合:底线、评分卡、如何与他们沟通
- 编写 brief.html
- 渲染并审计
- 检查事实、链接和版面
- 交付
1. 识别
- 有URL:打开首页和关于页面。只有名称:搜索
"<名称>" 公司和"<名称>" 官方网站。 - 确定品牌名称和法律名称、域名、总部、创立年份、创始人、上市或私有(股票代码)、母公司。
- 搜索
"<名称>" -<域>查找同名公司。 - 如果存在两个或更多真实公司可能匹配,且请求中没有任何信息可以区分它们,提出一个问题并列出候选公司。否则选择最匹配的一个,并在回复顶部说明。
- 在个人模式下,还要搜索过去的聊天记录和记忆(如果可用)中的公司名称:一份申请、招聘者对话或offer会改变重要内容。
2. 工作目录
mkdir -p briefs/<公司-简称> && cd briefs/<公司-简称>
cp "${CLAUDE_SKILL_DIR}/assets/brief.css" . && cp "${CLAUDE_SKILL_DIR}/assets/brief-template.html" brief.html
使用当前工作目录,如果不可写则使用临时文件夹。创建 research-notes.md,每个简报部分一个标题,并以 - <事实> | <标签> | <来源标题> | <URL> | <日期> 格式追加发现。
3. 首先查看公司自己的网站
实时网站和招聘页面能回答简报中三分之一的内容,并且是任务、价值观、产品、客户、办公室、开放职位、薪资、面试流程、社交媒体账号和品牌token的最可靠来源。
- 如果你有浏览器工具(Chrome中的Claude、应用内浏览器或云浏览器),使用它访问公司的域名;如果被询问,批准整个网站一次。将页面作为文本阅读,而不是截图,Logo和英雄区域除外。
- 按顺序访问:首页(定位、客户Logo、页脚社交账号和链接)→ 关于 → 招聘(按部门和地点统计职位数量)→ 最接近目标角色的2-4个职位发布(薪资、面试步骤、汇报线、工具)→ 新闻/新闻室(时间线、新闻资料包、Logo文件、品牌指南)→ 博客/更新日志(最近3个月)→ 活动 → 客户案例。
- 在查看首页时,同时运行品牌提取脚本(references/brand-extraction.md,第1节)。
- 没有浏览器:使用fetch工具获取相同页面。
- 招聘页面优于招聘网站API,后者通常数据陈旧。仅在手册中的ATS API列表作为后备时使用。
详细信息:references/research-playbook.md,第1-2节。
4. 其他所有内容
遵循 references/research-playbook.md 第3-6节。在同一轮中一起发送独立搜索(融资、收入、新闻、评价、竞争对手、活动、活动、播客)。首先使用标准搜索,对于近期新闻、招聘和评价数据或任何信息薄弱的部分使用扩展搜索。如果 fetch 工具拒绝了你输入的URL,搜索它然后fetch结果链接,或者在浏览器中打开它。如果有招聘网站(Indeed、ZipRecruiter、LinkedIn)的连接器,它们对评分和职位很有用。
对于一家中等规模的公司,进行40-80次查找是正常的。当一个部分在两次充分搜索后仍然信息薄弱时,将其标记为未知并继续。
5. 品牌token和字体
根据提取结果(references/brand-extraction.md):
python3 "${CLAUDE_SKILL_DIR}/scripts/fonts.py" "<展示字体>:400,500,600" "<正文字体>:400,600" "<标签字体>:400,500"
python3 "${CLAUDE_SKILL_DIR}/scripts/tokens.py" --brand "#…" --accent "#…" \
--font-display "<展示字体>" --font-body "<正文字体>" --font-label "<标签字体>" \
--display-weight 600 --tracking -0.02em --radius 8px \
--footer "<公司> · 公司简报 · <月 年>" [--cover-stops "#…,#…,#…"] > tokens.html
- 将 fonts.py 输出的
<link>行粘贴到 brief.html 中的字体链接标记处,将tokens.html粘贴到token标记处。 - tokens.py 报告的每一行都应显示
ok。出现WARNING意味着需要选择不同的颜色(对于浅色签名色,将深色设置为--brand)。 - 专有品牌字体:运行 brand-extraction.md 第2节中的替代字体测试,并在简报中说明使用了哪种免费字体作为替代。
- 如果 npm 无法安装字体,使用系统已安装的字体族(
fc-list : family),并在字体部分说明。
6. 品牌资料包
遵循 references/brand-extraction.md 第4节。在所有模式中,找到主要Logo的矢量文件(SVG、EPS、AI或矢量PDF)以及最新的公开品牌指南;在品牌工作模式下,还包括字体、颜色规格、图片、模板、样板文件和使用条款。同时发送这些搜索。对于每个项目,记录链接、通过打开文件确认的格式、来源(官方或第三方)、日期和状态:最新、过时、已过时、请求访问或未找到。检查Logo文件是否与今天实时网站上的Logo一致。
7. 综合
阅读整个笔记文件,然后决定:底线、需知的三件事、评分卡、他们的语言、优先级→谈话要点、30秒提案、沟通角度、面试准备、要问的问题、注意事项、签约前须知(仅当有offer时)以及接触方法。每项的指导:references/research-playbook.md 第7节。
8. 编写 brief.html
替换模板中的每个 {{placeholder}},根据需要添加行和项目,并仅删除模板标记为可选的章节。标记和写作规则:references/components.md。保持每份简报的CSS较小,并放在模板的覆盖块中。目标为14-20页。
9. 渲染并审计
node "${CLAUDE_SKILL_DIR}/scripts/render.cjs" brief.html "<公司>-公司简报-<YYYY-MM>.pdf" \
|| python3 "${CLAUDE_SKILL_DIR}/scripts/render.py" brief.html "<公司>-公司简报-<YYYY-MM>.pdf"
- Node渲染器在Playwright缺失时退出并返回代码2,这会触发Python渲染器。render.py会依次尝试Playwright、Chrome二进制文件,然后WeasyPrint(
pip install weasyprint)。 - 修复每一条
FAIL行(字体未加载、文本对比度低于4.5:1、残留占位符),然后重新渲染。 - 如果你在别人的个人电脑上运行且没有任何渲染成功,在安装渲染器之前先询问(
pip install playwright && python -m playwright install chromium)。
10. 检查
- 版面:
python3 "${CLAUDE_SKILL_DIR}/scripts/contact_sheet.py" <pdf> sheet.png,然后查看图片。封面为全出血且无页脚;摘要内容适合第2页;每个部分从新页开始;无内容被裁剪;无表格溢出;无接近空白的页面;无标题孤悬在页面底部。对有疑问的页面使用pdftoppm -r 150 -f N -l N -png <pdf> page以更高分辨率渲染后再次检查。 - 事实:PDF中的每个数字都与笔记文件匹配,带有标签,并出现在来源部分。日期是绝对的。未混入其他同名公司的信息。
- 文本:对照 references/components.md 中的写作规则再次阅读文本。
- 链接:打开至少5个来源链接以确认它们能打开,并打开每个品牌资料包链接以确认能打开并显示列出的格式。
11. 交付
- 发送PDF文件。在品牌工作模式下,同时发送
<公司>-品牌资料包.md:作为纯文本链接的资料包表格,方便直接粘贴到项目文档或频道中。如果提问者将简报保存在电脑的文件夹中且你能访问,也保存一份在那里。 - 用几句话回复:两句话概括底线、2-3个最精辟的谈话要点、任何你无法找到的重要信息,以及一个有用的下一步行动(例如定制的求职信、接触邮件草稿、模拟面试问题、启动会议议程或可共享版本)。在品牌工作模式下,说明你找到了哪些Logo和指南文件,以及团队需要请求访问哪些内容。