agentcard: Skill for Claude Code

agentcard-deploy — 带 fork 者把这张 AI 名片变成他自己的

一句话:这不是一张静态简历页,是一张会替主人接待、筛选、转化访客的 AI 终端名片。访客来了,它自我介绍、回答问题、识别是不是有合作意向、捕获线索并通知主人。这个 skill 带用户把 demo 里的内容换成他自己的,并把后端配起来。

This is not a static résumé page — it's an AI business card that greets, screens, and converts visitors on the owner's behalf. This skill walks a forker through replacing the demo content and wiring up the backend.

给 AI 的执行原则: 一步步来,每一步做完让用户确认再往下。不要用占位符批量覆盖用户内容——先访谈,拿到用户的真实信息再写。命令一律在 worker/ 或仓库根目录跑,涉及 secret 的让用户自己执行(你不经手任何 key)。

---

0. 先说清楚这东西是什么、为什么这么设计(理念 + 安全模型)

部署前先让用户理解设计,不然改起来会踩坑:

定位。 北极星是「每月有效合作线索」。不是博客(内容)、不是求职页(投递),而是:展示品味 → 回答问题 → 识别合作意向 → 捕获线索。终端世界观本身自带传播点(访客会截图)。

安全是结构性的,不是靠 prompt 求模型「别说」。 这是整个项目最该被继承的部分:

• DeepSeek key 只存 Worker secret,永远不进前端。 前端放 key = 当场被扒出来盗刷。前端只调 AI_ENDPOINT,key 在 ai-proxy.js 里从 env 读。
• 微信号只在 secret WECHAT_ID,经 offer_wechat 工具服务端门控发放。 明文不进 system prompt、不进页面——所以再怎么 prompt 注入也套不出来。门控:访客必须先留下自己的联系方式,服务端校验通过才返回;每会话最多放行 2 次。
• 完整简历 send_resume 四重门控: 邮箱必须是访客亲手在对话里敲的(模型编不出没出现过的地址)· 同邮箱 7 天不重发 · 每会话 1 次 · 全局每日 ≤10。邮件是固定模板 = 零注入面;不做任何自由外发邮件。
• 隐私红线: IP 只存 SHA-256 截断哈希;完整简历 PDF 无手机号 / 无薪资 / 无微信号;直接访问 /resume.pdf 无签名 token 一律 404。

内容 / 引擎分离(fork 的核心契约)。 你只需要改三处内容,引擎不用碰:

• worker/config.js —— 人设、事实基线、curl 名片、邮件模板、A2A 卡(全部个人内容在这)
• index.html 的 HTML 内容区 —— hero 文案、作品卡、能力、联系方式
• pdf-src/ —— 简历 / 合作简介的 HTML 源,重出 PDF
• worker/ai-proxy.js 是引擎,不用改(AI 代理 / 工具 / 落库 / 后台 / 通知 / A2A;所有对主人的引用都从 config.js 的 SITE 派生)。

A2A(差异点)。 别人的 agent 可以直接发现并询问你的名片:GET /.well-known/agent-card.json 发现 + POST /a2a(JSON-RPC message/send,带 contextId 自动多轮)。人不在场,两个 agent 先把匹配度聊完。

兜底。 AI 挂了 / 没配 key 时,ask 自动回退本地脚本应答,页面永不白屏。所有落库 / 通知都走 waitUntil 旁路,挂了不影响回答。

---

1. Preflight(环境 + 从模板起手)

node -v            # 需要 Node 18+
npx wrangler --version
cd worker
cp wrangler.toml.example wrangler.toml   # 真实配置(域名/Feishu/D1)在这里改,已被 gitignore
cp .dev.vars.example .dev.vars           # 本地联调用,填你的 DEEPSEEK_API_KEY,已被 gitignore