Trello 看板卡片规则
仅在 $JOB_SEARCH_HOME/integrations.yaml 中 tracker_backend: trello 时适用。如果后端是 jira,请改用 job-search-quality 技能中的证据门(evidence gate)。
所有看板和列表标识符均来自 integrations.yaml 中的 trello.*。请勿硬编码,也切勿打印 API 密钥或令牌。
重复检测 — 在任何卡片创建之前
三种失败模式,每种都曾产生过重复卡片:
1. 大小写。 "Upstyle" 和 "upStyle" 是同一家公司。大小写敏感的比较在一次运行中造成了 22 张重复卡片。比较前将两侧均转换为小写。
2. 职位标题变异。 "Senior DevOps Engineer- AWS" 和 "Senior DevOps Engineer - AWS" 是同一个职位。精确字符串匹配在空格和标点上会失败。
改用模糊匹配:从两个标题中提取关键词,去掉填充词(senior, staff, lead, principal, engineer, devops),要求有 2 个及以上重叠的关键词。
3. 仅凭标题评分高估了职位匹配度。 某个职位仅凭标题就在优先原则筛选中获得了满分,但实际招聘广告要求候选人没有的裸金属 GPU Kubernetes 技能。标题词汇只是筛选线索,绝不能作为水平证明。
在评分中添加一个技能匹配风险维度(0–2)。对照 $JOB_SEARCH_HOME/targets.md 中记录的候选人的弱点——裸金属、GPU、RDMA、InfiniBand、Ceph、Rook、硬件——以及招聘中介机构来检查职位。在不匹配时评分为 0。
操作步骤
第 1 步 — 重复检查
在创建任何内容之前运行追踪重复检查器:
- 公司:将两侧均转换为小写,然后进行子串包含检查
- 职位:去掉填充词,要求有 2 个及以上重叠的关键词
- 同时检查
company+role是否与integrations.yaml中的tracker_path存在匹配
如果存在匹配,则更新现有卡片而非创建第二张。
第 2 步 — 标题格式
按以下形状生成标题:
<Role> — <Company> (<Status>)
职位和公司之间使用短破折号,状态放在括号内。
第 3 步 — 放置到列表
从 trello.lists.* 读取列表标识符:
| 信号 | 列表键 |
|---|---|
| 默认 | backlog |
| 候选人说“已提交”或“已发送” | applied |
| 正在积极推进 | todo |
| 面试阶段 | interview |
| 已结束 | dead_leads |
如果配置中所需的列表键为空,则停止并命名该列表,而非猜测。
第 4 步 — 创建,然后记录
在解析出的列表中创建卡片,然后将其以 Saved 状态记录到 tracker_path。
如果创建成功但记录失败,则同时报告两种情况。存在但未记录的卡片将在下次运行时被重新创建。
第 5 步 — 附加文档
上传完成的 PDF 及其 HTML 源文件。在报告成功之前回读附件名称和大小。在替换有缺陷的附件时,先上传正确的文件,验证后再删除旧副本,以便审核者看到单一清晰版本。
凭据来自 trello.api_key_env 和 trello.token_env。从环境变量中读取;切勿内联到会被记录的命令中。
规则
- 未经重复检查切勿创建卡片。这就是本技能的全部意义所在。
- 切勿推断列表标识符、看板标识符或公司缩写。
- 配置中缺少列表时,应停止并报告,而非使用默认值。
- 切勿捏造职位信息。一张卡片必须对应一个真实的招聘广告。