Repository navigation
发布改走 npm trusted publishing(OIDC),新增发版 skill - #89
Conversation
npm 将于 2027-01 取消 bypass-2FA token 的直接发布能力。发布 job 去掉 NODE_AUTH_TOKEN 与 setup-node 的 registry-url,改用 OIDC 身份;首发由维护者本机交互式发布,之后登记 trusted publisher。完整发版步骤与失败处理落到 .telov/skills/release。
审查结论(head
|
| PR 中的断言 | 核对结果 |
|---|---|
| OIDC 发布需 npm CLI ≥ 11.5.1、Node ≥ 22.14.0 | 成立;workflow node-version: 24 满足 |
| OIDC 下切 dist-tag 需 11.21 / 12.2 | 成立,数字与官方一致 |
需要 id-token: write,可放 workflow 级 |
成立;官方示例就是 workflow 级,publish.yml:14 同形 |
Allowed actions:npm stage publish 恒允许、npm publish 需勾、npm dist-tag 默认关闭 |
成立;SKILL.md:88 的指引正确 |
| 新建配置 2 天内必须完成首次成功发布 | 成立(问题在于「成功发布」被幂等守卫跳过,见 B1) |
| 包必须在 registry 上已存在才能登记 trusted publisher | 成立;SKILL.md:79 的前提正确 |
| provenance 在 OIDC + 公开仓库 + 公开包下自动生成 | 成立 |
未验证
- OIDC 发布路径本身:包还没上 npm、没有 trusted publisher 配置,跑不起来。Note 与 PR 正文都明写了这一点,没有把未验证说成已验证。
npm install -g npm@latest在 GitHub runner toolcache 上的写权限:本机模拟不了。- 预发布
--tag的权限边界(同上「待确认」)。
复跑读数(worktree head c335f13)
npm run check全绿:verify-agent-note-format: 65 篇、verify-doc-tool-names: 11 篇、verify-doc-budgets: 13 篇、check-syntax: 96 个文件、verify-coverage: 975 用例通过(16 跳过)。npm run build:client+npm run verify:pack:86 个文件(未压缩 994 kB),必需项齐全、无开发残留,装机 smoke 通过。- 文档预算:
AGENTS.md3846 / 4280(余 434,10.14%,满足 10% 规则)、docs/limitations.md6312 / 6750(6.5%)、docs/development.md2372 / 2500(5.1%,满足 5%)。 - 全仓 workflow 已无
NODE_AUTH_TOKEN/NPM_TOKEN/ 生效的registry-url,只剩两处解释性注释(:52、:66)。 npm pack解包:.telov/未进包。tests/skills.test.js:17断言.agents/skills名单恰为['init-project','leader-mode']—— 印证「发版手册放.telov/skills,不随包发布」这个取舍是对的。
结论:B1 改掉文档后可以合并(B1 是文档不一致,不是代码缺陷)。不 approve、不 merge,等你的指令。
- publish.yml 钉 [email protected](与 actions 钉 SHA 同一条理由,浮动 tag 会在发布前引入未审阅代码) - 首发流程改为「本机发 0.1.0 → 登记 trusted publisher → bump 0.1.1 打 tag」:推 v0.1.0 会被版本已存在的幂等守卫跳过,OIDC 一次不跑、配置 2 天后静默过期 - doc-tool-names 扫描面改为 PROMPT_SKILLS_DIRS,纳入 .telov/skills(运维 skill 同样进提示词) - pack-manifest 黑名单补 .telov/,白名单被放宽时的第二道防线 - Note 补 actions/setup-node#1551(删 registry-url 的理由)与门禁读数
增量复审(head
|
背景
npm 已宣布 bypass-2FA 的 granular token 从 2027-01 起不能直接发布;2026-07-31 起这类 token 也不能再做 trusted publisher 配置等账户操作。本仓发布 job 仍用
NODE_AUTH_TOKEN,而包尚未发布、secret 也还没配——沿旧方案会在首个版本发出后立刻返工,且换配置那一步只能人工做。改动
.github/workflows/publish.yml:删掉NODE_AUTH_TOKEN与 setup-node 的registry-url(避免空_authToken抢先于 OIDC),改由id-token: write的 OIDC 身份发布;显式升级 npm(OIDC ≥ 11.5.1,OIDC dist-tag ≥ 11.21 / 12.2)。docs/development.md/docs/limitations.md:发布节改为 OIDC 契约与「首次发布例外」,删掉NPM_TOKEN的过时说法。.agents/notes/2026-11-03-npm-oidc-publishing.md:记录决策与边界;旧 note 的过时段落改为指向新 note。.telov/skills/release/SKILL.md:发版手册(定版本号 → bump →release:check→ PR → 合并后打 tag),含首发流程与失败处理。放在.telov/skills/而不是.agents/skills/,因为它不随包发布。AGENTS.md:发版入口指向 skill;scripts/doc-budgets.json的 AGENTS.md 天花板 4200 → 4280(按 10% 余量重算)。验证
npm run check:65 篇笔记格式合规;12 篇文档工具名全部存在(含新增的.telov/skills/release/SKILL.md);13 篇 standing docs 在天花板内(AGENTS.md 3846/4280、docs/development.md 2379/2500);语法 96 个文件;977 用例通过(16 skip),覆盖率门禁通过。npm run verify:pack:86 个文件(未压缩 994 kB),必需项齐全、无开发残留、装机 smoke 通过。PROMPT_SKILLS_DIRS回退成只含.agents/skills时扫描面用例变红;撤掉.telov/黑名单条目时打包用例变红;还原后均全绿。yaml.safe_load解析通过,setup-node 仍是node-version: 24+cache: npm。合并后需要你本机执行
npm login→npm publish(首发 0.1.0,真实 2FA OTP;这一步没有 provenance)。fengshenx/dsh-leader-kit/publish.yml,Allowed actions 勾npm publish(预发布再勾npm dist-tag)。release:check→ PR 合并 → 从main打v0.1.1tag。这一步才是首次 OIDC 发布。不要直接推
v0.1.0:0.1.0 已在第 1 步发布,publish.yml的「版本已存在就跳过」守卫会打印「已发布,跳过 npm publish」并 exit 0——workflow 绿色,但 OIDC 一次都没跑,trusted publisher 配置 2 天后静默过期,CI 读数看不出区别。gh run view的发布步骤:必须是npm notice Publishing ...,不能是「已发布,跳过 npm publish」。合并后不要立刻推 tag:先完成第 1、2 步,否则 CI 会 ENEEDAUTH。