buildr-release

Files (52)

• SKILL.md
• application-payload-entry.ts · scripts/
• application-payload.ts · scripts/
• candidate-failed-shard-retry.ts · scripts/
• candidate-package.ts · scripts/
• candidate-repair-operation.ts · scripts/
• candidate-source-binding.ts · scripts/
• candidate-step-timings.ts · scripts/
• candidate-adoption.ts · scripts/dsh-plugin/
• release-candidate.ts · scripts/dsh-plugin/
• release-workflow.ts · scripts/dsh-plugin/
• release.ts · scripts/dsh-plugin/
• trusted-publish.ts · scripts/dsh-plugin/
• environment-approval.ts · scripts/
• github-release-ensure.ts · scripts/
• mysql-connection-entry.ts · scripts/
• package-artifact-observation.ts · scripts/
• package-compatibility.ts · scripts/
• package-pair-diagnostics.ts · scripts/
• package-release-operation.ts · scripts/
• package.json · scripts/
• plugin-hosted-release.ts · scripts/
• registry-version-state.ts · scripts/
• release-artifact.ts · scripts/
• release-authority-oidc-probe.ts · scripts/
• release-authority-preflight.ts · scripts/
• release-authority.ts · scripts/
• release-contract.ts · scripts/
• release-convergence.ts · scripts/
• release-execution-binding.ts · scripts/
• release-executor-admission.ts · scripts/
• release-executor-recovery.ts · scripts/
• release-failure.ts · scripts/
• release-files.ts · scripts/
• release-git-convergence.ts · scripts/
• release-lifecycle.ts · scripts/
• release-notes.ts · scripts/
• release-observation.ts · scripts/
• release-orchestration-runner.ts · scripts/
• release-package-evidence.ts · scripts/
• release-phase-timeline.ts · scripts/
• release-publication.ts · scripts/
• release-readiness.ts · scripts/
• release-rehearsal.ts · scripts/
• release-selection.ts · scripts/
• release-tag-ensure.ts · scripts/
• release-targets.ts · scripts/
• release-task-evidence-correlation.ts · scripts/
• release-transaction-evidence.ts · scripts/
• release-transaction-runner.ts · scripts/
• runtime.ts · scripts/
• trusted-publish.ts · scripts/

SKILL.md (first lines)

# Buildr 发布

日常修改涉及初始化、安装、源码包或验证工具时，使用现有受影响入口覆盖相关链路，不等发布才检查。候选运行期间不改源码；同轮先跑完独立检查、汇总失败，取得用户同意后修复；接续只重跑失败项并首次执行未执行项。定位源码检查失败直接使用现有 `test:related -- --check <check-id>`，正常日志保留用例名称和耗时，同轮已通过的真实结果直接采用，不再手写旁路诊断后重复跑一次。原包失败继续使用准确原包的原验包入口，不重新制包。

本技能（Skill）拥有 Buildr 自举工作空间的发布流程与随附发布代码，不作为 npm 内置技能分发。先读唯一流程正文 `projects/product/knowledge/docs/flows/open-source-release.md`：固定候选、跑测试、打包、验包、发布。人决定目标和公开授权；智能体（Agent）按当前事实推进。

## 执行入口

发布代码的唯一源是所选源码检出位置的 `skills/buildr-release/scripts/`。从该位置的 `projects/product/services/buildr/` 使用 `tools/development/run-development-node ../../../../skills/buildr-release/scripts/release-orchestration-runner.ts --help` 查看当前参数，再调用 `prepare`、`inspect`、`publish --authorized` 或 `resume`。投射到智能体的技能副本用于发现和指引；不要从投射目录运行绑定源码的脚本。工作流（Workflow）也调用同一源码脚本。

正常准备和接续使用 `--wait`，由程序等待同一远端运行，每次状态变化只返回简短进度；默认最多等待 30 分钟，可用 `--wait-timeout-ms` 调整。默认输出摘要；需要原始证据时使用 `--output <file>`，仅诊断具体问题时使用 `--detail full`。等待期间不反复调用 `inspect` 或读取全部日志；真实失败、缺少本机证明或授权时，程序返回对应缺项。

冻结所选包、独立版本、分支（Branch）、准确提交（Commit）、源码树和准确对端，正常准备不跟随 `dev`。全部检查及结果汇总交给产品既有验证框架；先查看本轮普通日志中的成功、失败、未执行项和耗时，再只执行失败及未执行部分。不要因阶段切换重复执行仍有效的检查；一轮集中收集互不依赖的失败，经用户同意修复后只补失败及未执行项。同一发布轮内源码输入变化时，使用 `source.ts --invalidate <step-id,...>` 只重跑受影响步骤，其余通过记录继续采用；新候选轮次（新版本或新选择）从头完整执行。修复确认并提交版本材料后，直接以本次 selectionId/roundId 运行源码轮并写入候选 round 路径，使该轮成为候选证据；不要先跑一套独立全量再重复候选全量。本机能充分证明的在本机完成，GitHub 只补真实平台、干净环境或受保护执行边界。相关开发检查在改动交付前完成，避免到发布时才修过时检查。不要在检查运行时改变其源码或共享 Git 比较事实。

通用产品逻辑与功能只有一套，不按系统重复。操作系统相关的源码和原包检查是独立节点：本机是 macOS 就本机完成 macOS、远端补 Windows；本机是 Windows 则交换。源码入口 `test/verification/source.ts --round <selection-id> --output <round-log.json> --scope common|platform|all` 使用同一检查登记；默认先满足本机源码，远端补另一系统源码，全部通过后 GitHub 生产唯一原包。

README 固定标题、章节和编辑表达不作发布门槛。检查失败先判断是否保护功能、安全或交付正确性，无独立价值的措辞检查直接删除；必要的文档链接、渲染、资源引用和敏感信息检查按实际影响选择，不因文档改动追加整组快速检查，也不为技能（Skill）正文另写措辞断言。架构及规范静态检查留在相关开发检查中，不加入候选必跑集合。插件本机源码预检使用 `tools/verify-source.ts`（可用 `--round <selection-id> --output <round-log.json> --invalidate <step-id,...>` 保存普通结果），无需准备软件开发工具包（SDK）或旧主包对端；准确候选配对仍保留完整检查。

新准备把通用原包检查与本机系统验包留给本机。制包上传后，下载同一原包，与另一系统的远端验包并行；使用实际 Node `24.15.0` 运行 `tools/development/run-development-node test/verification/artifact.ts --artifact-dir <原包目录> --output <证据目录>`，默认一次检查通用原包、本机启动和最低 Node，不另跑当前版本。`--scope common` 只检查通用原包，`--scope platform` 只检查本机系统；macOS 和 Windows 对称选择，互不附带另一系统或已完成的通用检查。实际程序与系统随结果保留。`local-artifact-verification-required` 或远端 `incomplete` 表示仍等本机缺项，不是完整候选通过；完成后继续原 `prepare --artifact-verification <证据目录>`，仅采用原包与有效结果、补缺项和完整汇总，不重新产包。远端发布始终另需准确授权。

主包产包入口是 `scripts/candidate-package.ts`，插件发布代码在 `scripts/dsh-plugin/`；一般构建和验证工具仍归相应服务。每个包只生产一份准确原包，测试或汇总修复不默认重打；产品及真实构建输入变化才使相关原包和证明失效。正式补验绑定独立验证来源，不授予补验代码公开权限。

只准备到验包时使用 `prepare --stop-after candidate`：完整候选与原包检查通过后，把原包和证明保全到规范工作空间，通过既有任务应用登记验证报告和结果材料，并关联本轮要求的过程报告，结束准备任务；不进入 `main` 采用或公开。返回后核对逐项收尾结果，不把 `candidate-verified` 单独当作资源已清理。登记失败只恢复登记；工作树（Worktree）中的执行程序不能自删目录，退出后立即按返回动作接续清理。正常待发布候选保留仍有用途的冻结引用（Ref），不默默遗留临时资源；已有公开授权或请求的旧选择不能用于此模式。

已完成准备仍可检查或明确接续同一冻结选择，不重开任务、不重新制包或重测。需要纳入新源码、重新冻结或处理主线身份漂移时，先按明确目标恢复活动准备，再走既有写入边界；任务完成不授予公开权限。

主包和插件共用发布后回读等待：正常最多查询24次、间隔20秒，版本可见即结束；普通日志保留命令退出码、查询结果和耗时。等待窗口用尽只接续同版本回读，不因尚未可见重新上传。插件原受保护运行已尝试写入，随后准确原包已公开时，直接结合原运行记录补登记，保留其真实失败状态，不为刷新登记再开远端恢复运行，也不重新下载已公开包的候选。未知原包或原包冲突继续局部停止。

联合发布中，已确认成功的包直接采用既有结果，不在等待另一包时反复查询运行、下载发布记录或读取公开原包；新的公开写入仍核对其当前对端。声明完整时只下载当前待写入包的候选，旧包缺少兼容声明时仍保留必要的真实配对检查。使用一次正常等待和一次实际收尾返回值，不反复调用只读检查、重新保存同一报告或重新核验已清理对象。

将用户意图路由到正文对应入口：检查只读当前事实；准备停在公开发布之前；发布需有当前所选包准确版本与内容的授权；恢复保留已成立效果，仅继续未完成事项。已有授权在范围未变时继续有效，平台权限及必要审批仍须满足。

检查失败只补相关检查，汇总失败只恢复汇总，未知请求先回读；登记或清理失败保留已发生公开事实。完成时报告逐包结果、真实耗时、采用的旧结果和未验证边界，并明确本机开发应用未更新（activation 为 not-run）；本机更新另行授权 `buildr-self-bootstrap-sync`，不等待自举激活。任务登记以实际保存返回值为准，不为证明同一次保存反复打开界面；登记和清理各完成一次，失败只恢复对应动作。发布任务自己的工作树由发布收尾处理；执行者用于修复的工作任务工作树和临时资源不属于发布任务，应按 `task-finish` 核验清理或在结果中说明保留原因，不静默遗留。

每次候选准备或发布结束、中断后，依据本次已有执行记录做简短回看，在原发布任务材料中保存并引用原始日志，核心只有三点：（1）耗时分析，区分准备、等待、执行及修复补验，指出主要耗时项，缺失数据注明未知；（2）判断是删还是改，先审视相关检查或流程是否必要，再建议删除、简化或修正，保留必要的功能、安全与真实平台验证；（3）根据实际问题提出最多5项改进建议。正常执行简短记录即可；不为回看新增检查、重跑或阻塞发布，改进按后续授权实施。

From BuildrAI/Buildr, MIT.

More from BuildrAI/Buildr