OfferLoop 0.1.0-alpha.9

OfferLoop 0.1.0-alpha.9

发布日期：2026-08-13

本版本把 OfferLoop 的公开安装入口收敛为“完整安装 9 个求职 Skill”与“只安装单个 Skill”两种方式，并支持用户按需接入配套飞书知识库。

新增

• 新增统一安装入口 scripts/setup_offerloop.py。
• 支持完整模式：一次安装 9 个 Skill，并在用户授权后接入三张业务 Base 和私有知识库。
• 支持单 Skill 模式：只安装指定 Skill，不要求初始化整套飞书空间。
• 新增可恢复的安装模式、工作区配置和真实在线验收状态记录。
• 为 9 个 Skill 补齐完整模式与单 Skill 模式的运行契约。

安装

完整安装：

python3 scripts/setup_offerloop.py --agent codex --mode full

只安装一个 Skill：

python3 scripts/setup_offerloop.py \
  --agent codex \
  --mode single \
  --skill resume-tailor

完整命令、支持的 Agent、9 个 Skill 清单和飞书初始化边界见 README.md。

兼容性与迁移

• 旧版 scripts/install_offerloop.py 仍可管理本地 Skill，但不再代表飞书工作区已经完成初始化。
• 已有用户升级时保留本地用户文件、三张 Base、知识库内容和非敏感 locator。
• 配套飞书知识库属于可选线上配置，下载和本地安装不会自动创建飞书资源。
• 单 Skill 模式跳过全局画像门禁，默认在 Chat 中完成当前能力的交付。

验证

• GitHub Actions 在 Ubuntu、macOS、Windows 上完成冷安装与幂等性检查。
• Python 3.10 和 3.12 测试通过。
• 9 个 Skill 均完成独立安装和验证覆盖。
• Loop Runtime 31 项测试通过，配套模板构建与基线测试通过。

验收说明

本次发布没有独立的新飞书账号可用于真实线上冷启动，因此该项由仓库所有者明确豁免，并未标记为“通过”。账号盘点过程中只执行了只读检查，没有创建或修改任何飞书资源。线上首次安装仍应遵循 README 的授权、幂等检查和只读验收流程。

OfferLoop v0.1.0-alpha.11

OfferLoop 0.1.0-alpha.11

发布日期：2026-08-13

本版本补齐早期 job-collection、recruiting-reminder 用户迁移到当前 9 个 Skill 的正式引导，并让 GitHub Release 源码包包含最新迁移文档。运行逻辑与 schema v6 数据契约没有变化。

迁移引导

• README 新增旧双 Skill 用户的醒目升级入口。
• 明确先保留旧目录、执行 --dry-run，确认后再使用 --upgrade。
• 说明 conflict 是防覆盖保护，旧 Skill 会备份到 .offerloop-backups/<时间戳>/。
• 区分本地 9 个 Skill 安装验证与可选飞书空间接入；needs_setup 不代表本地安装失败。
• MIGRATION.md 补充旧配置、邮件去重状态、旧双 Base、schema v6、飞书按需接入和回滚步骤。

兼容性

• 继续沿用 alpha.10 的 schema v6、9 个 Skill 和三张业务 Base 契约。
• 安装和升级保持幂等，不自动覆盖旧 Skill，不复制已有 Base 或知识库内容。
• 配套飞书知识库仍为可选项，不影响本地完整安装或单 Skill 安装。
• 不要求旧用户删除现有配置、邮件状态或线上资源。

发布验证

• README 安装与迁移契约通过。
• Python 全量 168 项测试通过。
• GitHub Actions 将在 Ubuntu、macOS 和 Windows 上执行冷安装检查。
• Python 3.10、3.12 与两个配套模板构建均纳入必需检查。

升级建议

早期双 Skill 用户请从 README 的“旧版用户”入口开始；新用户继续选择“完整安装”或“单 Skill 安装”。本版本不要求重新迁移已经通过 alpha.10 验收的 schema v6 Base。

OfferLoop v0.1.0-alpha.10

OfferLoop 0.1.0-alpha.10

发布日期：2026-08-13

本版本将求职进展数据契约升级为 schema v6，并同步更新 9 个 Skill、安装验证、招聘信息同步、招聘提醒与配套飞书知识库契约。

主要变化

• 将 进展状态 设为求职进展的当前状态唯一真源。
• 新增 公告链接，并与求职企业清单逐值同步。
• 为 最近完成节点 增加 面试完成，保留群面、一面、二面、三面和 HR 面等细分节点。
• 移除业务 Base 中的 投递简历版本；简历选择只保留在具体简历任务上下文中。
• 对齐六张企业清单表的 招聘批次 选项。
• 新增 schema v6 在线验证脚本和迁移验收契约。

兼容性与迁移

• 已有 Base 可暂时保留 当前阶段、下一环节、流程结果 和 当前状态，仅供迁移及旧客户端兼容。
• 新逻辑优先读取 进展状态；该字段为空时才从兼容字段迁移，无法可靠判断时写入 状态待确认。
• 企业记录首次进入 已投递 时，默认创建 待反馈 / 投递完成 的求职进展。
• 安装和升级继续保持幂等，不复制已有 Base、知识库内容、本地用户文件或非敏感 locator。
• 配套飞书知识库仍是可选线上配置，不影响 9 个 Skill 的本地安装。

验证

• 求职进展 46 条记录完成 公告链接 回填并通过 schema v6 在线校验。
• 六张企业清单表的 招聘批次 选项一致。
• 七张相关表均已移除空字段 投递简历版本，删除前确认没有有效数据。
• GitHub Actions 在 Ubuntu、macOS 和 Windows 上完成冷安装检查。
• Python 3.10 与 3.12 全量测试通过。
• 招聘同步模板、进展同步服务及相关契约测试通过。

验收说明

本次迁移已在现有授权账号中完成真实 Base 结构、记录回填、知识库首页和线上同步服务验收。由于没有独立的新飞书账号，跨账号首次冷启动没有重新执行；该项由仓库所有者明确豁免。新用户首次接入仍应遵循 README 中的只读检查、授权确认和幂等初始化流程。

v0.1.0-alpha.4

OfferLoop 0.1.0-alpha.4 发布说明

状态：预发布版本。日期：2026-07-23。

本次版本重新组织新用户文档，让安装、首次使用和后续增量更容易理解。四个 Skill 的业务能力、权限边界和数据合同没有变化。

README 重构

• 按用户旅程重新组织 README：安装前准备、安装方法、四个 Skill、旧用户升级和其他说明。
• 在安装前准备中说明必需条件、检查方法，以及条件不满足时的解决办法。
• 提供两种通用安装入口：把 GitHub 链接交给支持标准 Skill 的 Agent，或使用终端安装命令。
• 删除针对具体 Agent 产品的逐项安装教学，统一使用标准 SKILL.md 和 Agent 自身的 Skills 目录表达。
• 分别说明四个 Skill 的作用、首次运行前准备、首次运行流程、首次输出、后续增量和案例。
• 明确 offerloop-setup 负责部署工作台和技术配置，offerloop-workspace 负责创建私有求职空间并接入已有工作台。
• 明确求职偏好由 job-collection 渐进询问，而不是由 offerloop-setup 收集。

安装

可以把仓库链接交给当前 Agent，请它安装 skills/ 下的四个标准 Skill；也可以在终端运行：

npx skills add riwonswain-ovo/OfferLoop -g \
  -s offerloop-setup job-collection recruiting-reminder offerloop-workspace -y

安装完成后需要重新开启 Agent 会话，再调用 offerloop-setup 运行只读预检。

验收范围

• 文档契约测试验证 README 五个主要章节的顺序。
• 每个 Skill 都必须包含作用、首次准备、首次流程、首次输出、后续增量和案例。
• 安装与升级说明保持 Agent 中立，不包含特定 Agent 参数或产品专属教学。
• 原有安装器、冷安装、配置、同步和业务合同测试继续执行。

边界

这是 prerelease。本次没有新增业务功能，也不改变飞书、邮箱、日历、知识库或工作台的权限要求。文件安装和离线预检不代表线上能力已经可用，真实身份、scope、租户安装和资源权限仍需逐项核验。

OfferLoop 0.1.0-alpha.3

OfferLoop 0.1.0-alpha.3 发布说明

状态：预发布版本。日期：2026-07-23。

本次版本聚焦新用户第一次下载和安装 OfferLoop 时的可理解性、反馈准确性与安装速度，不改变飞书、邮箱、日历、知识库或工作台的授权边界。

安装体验修复

• README 顶部新增三步快速开始，明确 OfferLoop 会同时安装四个协作 Skill。
• 区分“Skill 文件已安装”“本机预检通过”和“线上能力可用”，避免把 needs_action 或 unverified 误判为安装失败。
• --dry-run 的普通终端输出明确显示未写入文件，并以 would install、would upgrade 描述计划动作。
• 安装成功后直接提示结束当前 Agent 会话、新开会话并调用 offerloop-setup 运行只读预检。
• 安装器在源校验、摘要计算与复制阶段直接剪枝 node_modules、dist 和 build。即使模板在本机执行过依赖安装或构建，也不会再因遍历生成文件而长时间无输出。
• 保留原有 JSON 状态、幂等安装、冲突不覆盖与升级前备份契约。

验收范围

• 仓库单元测试覆盖 dry-run 不写入、普通输出不误报成功、安装后提示和生成目录剪枝。
• 冷安装验收覆盖 Codex、Claude Code、Hermes 与腾讯 WorkBuddy 的四 Skill 安装、重复安装和 collection 首次预检。
• GitHub Actions 继续在 Ubuntu、macOS 和 Windows 执行冷安装，并在 Python 3.10/3.12 下运行仓库合同测试。
• 两份妙搭模板继续执行锁定依赖安装、测试、类型检查和构建。

安装

git clone https://github.com/riwonswain-ovo/OfferLoop.git
cd OfferLoop
python3 scripts/install_offerloop.py --agent codex

将 codex 替换为 claude-code、hermes-agent 或 workbuddy。安装后结束当前 Agent 会话并新开会话，再调用 offerloop-setup 运行只读预检。

边界

这是 prerelease。文件安装和离线预检不验证飞书身份、scope、应用版本发布、租户安装、资源共享、邮箱授权、日历授权或工作台 OAuth；这些条件仍须按用户与资源逐项核验。

OfferLoop 0.1.0-alpha.2

本次更新

• 为腾讯 WorkBuddy 管理的低版本 lark-cli 提供安全恢复指引，避免复制可执行文件、删除 profile 或写入 OfferLoop 业务配置。
• 已在真实 WorkBuddy 5.1.7 新任务中复验：lark-cli 1.0.76 且可发现 profile 后，collection 本地检查没有 blocked 或 needs_action。
• Codex、Claude Code、Hermes、腾讯 WorkBuddy 继续统一安装四个公共 Skill，不新增 Agent 专属业务副本。

验收

• 干净副本：93 项仓库测试、共享 AgentSkills 兼容检查、四 Agent 隔离 HOME 冷安装通过。
• GitHub Actions：Ubuntu、macOS、Windows 冷安装、Python 3.10/3.12 测试、两份模板构建共 7 项检查通过。

边界

这是一项 prerelease。飞书、邮箱、日历、知识库和工作台的在线身份、scope、资源权限及任何写入能力，仍必须按用户与资源单独验证。

OfferLoop v0.1.0-alpha.1

OfferLoop 的首个多 Agent 预发布版本。

主要更新

• 提供统一安装器，支持 Codex、Claude Code、Hermes 和腾讯 WorkBuddy。
• 四个公共 Skill 保持为唯一业务真源：offerloop-setup、job-collection、recruiting-reminder、offerloop-workspace。
• 安装支持幂等检查、同名冲突保护、--dry-run、脱敏 JSON 输出和升级前可恢复备份。
• 修复 Hermes 外部 Skill 同名碰撞，并为 Agent 环境中的旧版 Python 增加 3.10+ 自动恢复。
• WorkBuddy 5.1.7 已完成真实 Skill 发现、加载和四项离线预检认证。
• 移除 OpenClaw 支持，避免对未继续验证的平台作兼容承诺。

安装

git clone https://github.com/riwonswain-ovo/OfferLoop.git
cd OfferLoop
python3 scripts/install_offerloop.py --agent codex

将 codex 替换为 claude-code、hermes-agent 或 workbuddy；也可使用 --agent all。

认证边界

• Codex、Claude Code、Hermes、WorkBuddy 均已通过真实 Agent 加载与离线执行门禁。
• Claude Code 在 CC Switch 当前启用的第三方模型环境中完成 offerloop-setup 加载及 collection 离线预检；该结论只覆盖实际测试的 Provider 与模型，不代表 CC Switch 中的所有模型或官方 Anthropic 后端。
• WorkBuddy 环境仍需升级至 lark-cli >= 1.0.73 并选择可用 profile。
• 飞书、邮箱、日历、知识库及所有写入能力仍需按用户身份与资源权限分别验证。

发布后认证更新

2026-07-22：Claude Code 个人安装副本升级到发布版后，在新会话中明确报告 Skill(offerloop-setup) 加载成功，并从个人 Skill 安装目录执行 collection JSON 预检；返回 schema_version: 1、local.skills: ready，其余本地项均为 ready。本次未写配置，也未访问线上资源。

完整说明见仓库中的 docs/agent-compatibility.md 和 docs/cases/runtime-certification-2026-07-22.md。