@weotro/dx 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weotro/dx",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "license": "MIT",
   "repository": {

package/skills/cc-ship-issue-pr/SKILL.md

@@ -5,22 +5,9 @@ description: 仅在用户显式调用 $cc-ship-issue-pr、/cc-ship-issue-pr 或
 
 # CC Ship Issue PR
 
-Claude Code 入口：主进程守门并执行轻改动，Codex 承接重改动的方案讨论、实现与独立审查。
+Claude Code 入口：主进程执行轻改动，Codex 承接重改动的方案讨论、实现与独立审查。
 
-## 步骤一：Claude Code 门禁
-
-任何文件检查、Git/GitHub 操作或共享流程加载之前执行：
-
-```bash
-if [[ -z "${CLAUDECODE:-}" ]]; then
-  echo "cc-ship-issue-pr 仅允许 Claude Code 调用；当前运行时不是 Claude Code，已退出。"
-  exit 64
-fi
-```
-
-门禁失败后立即结束。门禁通过的完成标准是 `CLAUDECODE` 非空。
-
-## 步骤二：加载共享流程
+## 步骤一：加载共享流程
 
 ```bash
 AGENTS_ROOT="${AGENTS_HOME:-$HOME/.agents}"

package/skills/git-release/SKILL.md

@@ -7,7 +7,7 @@ description: 仅在用户显式调用 $git-release 或明确要求使用 git-rel
 
 ## 目标
 
-在 `release/vX.Y.Z` 或 `release/vX.Y.Z-<prerelease>.N` 分支上，完成从发布前检查、GitHub Release 创建、生产服务器验证到发布后回访 Issue 建立的全流程；若当前不在 release 分支，则先从最新 `main` 自动创建目标 release 分支。
+在 `release/vX.Y.Z` 或 `release/vX.Y.Z-<prerelease>.N` 分支上，完成发布前检查、GitHub Release 创建和发布后运维回访 Issue 建立；若当前不在 release 分支，则先从最新 `main` 自动创建目标 release 分支。
 
 ## 执行原则
 
@@ -15,6 +15,8 @@ description: 仅在用户显式调用 $git-release 或明确要求使用 git-rel
 - 严格执行前置校验，任何硬性条件不满足时立即终止。
 - 发行说明必须结构化、可读、可追溯。
 - 发布完成必须留下一个可追踪的部署后回访 Issue；终端里临时打印 checklist 不算完成。
+- 本技能只编写回访 Issue，不执行生产验证。不得登录生产服务器、访问生产数据库、调用生产只读接口、查询生产监控或尝试取得生产凭据。
+- GitHub Release 创建成功不代表已经部署。Issue 中部署、迁移、服务、数据和业务验收项默认全部未勾选，留给运维或后续回访 agent 执行并补充证据。
 - 命令默认在仓库根目录执行。
 - 若能从当前 release 分支或自动建分支流程唯一推断出合法版本号，直接使用该版本继续发布，不要询问用户确认。
 
@@ -159,17 +161,14 @@ EOF
 
 4. 读回 Release，确认 tag、标题、正文和 URL 正确：`gh release view v<VERSION> --json tagName,name,body,url,isDraft,isPrerelease`。
 
-### 六、生产环境验证与发布后回访
+### 六、创建发布后运维回访 Issue
 
 1. 完整读取 [发布后回访契约](references/post-release-follow-up.md)。
-2. 从仓库实际部署配置和运维文档确定生产服务器、连接方式、服务、品牌、target、版本标记、数据库和只读验证入口；禁止猜测主机或使用历史地址。
-3. 直接登录每台相关生产服务器，核对实际运行版本/commit、进程或容器、health/readiness、关键日志、worker/cron 和资源状态，确认部署事实而不是依赖流水线状态。
-4. 根据发行说明、PR、迁移和运维脚本识别本次需要人工执行的脚本，使用迁移表、任务记录、审计日志、marker、状态命令和数据结果验证是否已经执行且结果符合预期。检查默认只读；未经当前用户明确授权，不执行生产写脚本、迁移、回填、重启或重新部署。
-5. 自动创建一个发布后回访 Issue。Issue 必须覆盖：发布与服务器版本一致性、服务健康、运维脚本执行状态、数据结果、配置、可观测性、本次变更特有验收、回滚准备和延迟观察窗口。
-6. 立即执行当前可验证的检查；只有附有脱敏命令、查询结果摘要、日志位置或可观察结果的项目才能勾选。缺生产权限或需要观察窗口的项目保持未勾选，并写清所需权限或最早检查时间。
-7. 使用 `gh issue view` 读回 Issue，确认没有占位符、每个生产目标和本次发布影响面都有对应检查项，并输出 Issue URL。
-
-GitHub Release 已创建但无法登录生产服务器、实际版本不匹配、必需运维脚本未执行或数据不符合预期时，仍然创建回访 Issue，把状态标为阻塞并立即向用户报告证据、影响、建议动作和重新验证项；不得静默修复或用“Release 已创建”掩盖生产问题。
+2. 只读取仓库内的部署配置、运维文档、发行说明、PR、迁移和 ops manifest，确定预期环境、品牌、target、服务、数据库、脚本与用户可观察变化。不得通过 SSH、生产域名、数据库、监控平台、云平台 API 或私有环境配置验证当前生产状态。
+3. 自动创建一个发布后回访 Issue。Issue 必须覆盖：部署前门禁、发布与服务器版本一致性、服务健康、迁移与运维脚本、数据结果、配置、可观测性、本次变更特有验收、回滚准备和延迟观察窗口。
+4. 部署与生产验证状态写为“待运维执行”。所有需要部署后取证的 checklist 保持未勾选，并写清执行对象、预期结果和应附的脱敏证据；不得因为 Release 已创建或 CI 状态正常而代替勾选。
+5. checklist 应明确要求运维或后续回访 agent 按仓库配置登录每台相关生产服务器，核对实际版本、进程或容器、health/readiness、日志、worker/cron、资源、迁移、配置和数据结果。本技能当前调用不执行这些检查。
+6. 使用 `gh issue view` 读回 Issue，确认没有占位符、每个生产目标和本次发布影响面都有对应未勾选检查项，并输出 Issue URL。
 
 ## 终止条件
 
@@ -205,6 +204,6 @@ GitHub Release 已创建但无法登录生产服务器、实际版本不匹配
 - 分支名
 - tag 推送状态
 - Release URL
-- 生产服务器、实际运行版本与验证状态
+- 预期部署环境、品牌与 target
 - 发布后回访 Issue URL
-- 已验证、阻塞、待授权、待观察项目数量
+- 待运维执行与待观察项目数量

package/skills/git-release/references/post-release-follow-up.md

@@ -1,94 +1,118 @@
-# 发布后回访契约
+# 发布后运维回访 Issue 契约
 
-本文件只在 GitHub Release 创建成功后读取。目标是把部署后的未知风险变成一个有证据、可关闭的 Issue，而不是生成一张固定且无法证明完成的清单。
+本文件只在 GitHub Release 创建并读回成功后使用。目标是生成一张可交给运维或后续回访 agent 执行的部署与验证 checklist，不是在当前 `git-release` 调用中验证生产环境。
+
+## 职责边界
+
+当前 `git-release` agent 只做以下工作：
+
+- 从仓库内的部署配置、运维文档、发行说明、提交、PR、迁移和 ops manifest 建立发布影响面；
+- 创建并读回发布后回访 Issue；
+- 把每个部署与验证动作写成可执行、可取证的未勾选检查项。
+
+当前调用不得连接或探测生产环境，包括 SSH、生产数据库、生产域名或 health 接口、监控平台、云平台部署 API、服务器日志和私有环境 profile。不得为了填写 Issue 尝试取得密钥、token、主机权限或数据库权限。
+
+GitHub Release、tag、CI 状态或部署工作流的存在都不代表已经部署。Issue 的初始状态统一写为“待运维执行”，所有部署后检查项保持未勾选。
 
 ## 完成边界
 
 `git-release` 本次调用完成的最低条件是：
 
 - Release 已读回确认；
-- 已从实际配置确定或明确无法确定生产服务器与验证入口；
-- 已登录所有相关生产服务器核对实际运行状态，或记录无法访问的证据；
-- 发布后回访 Issue 已创建并读回；
+- 已从仓库内真源确定预期环境、品牌、target、服务、数据库与运维脚本，无法确定的内容明确列为待运维补充；
+- 回访 Issue 已创建并读回；
 - 本次发布涉及的每个环境、品牌、target、迁移、配置和用户可观察变化都有检查项；
-- 当前能自动验证的项目已执行，只有带证据的项目被勾选。
+- 每个检查项写明执行对象、预期结果和应附的脱敏证据；
+- 没有把未经生产取证的项目标成已完成，也没有声称实际生产版本或健康状态。
+
+回访 Issue 不要求在当前调用中关闭。运维或后续回访 agent 应在部署后更新同一个 Issue，逐项补证据并勾选。
 
-回访 Issue 不要求在当前调用中关闭。需要观察窗口、人工账号或业务确认的项目保持未勾选，避免为了“流程完成”伪造通过状态。
+## 从仓库建立影响面
 
-## 生产服务器核验
+只检查本地仓库真源，包括部署脚本、inventory、`dx/config/commands.json`、`dx/release/`、systemd/container 配置、runbook、迁移目录和 ops manifest。确定：
 
-先检查仓库真实部署配置和运维文档，包括部署脚本、inventory、`dx/config/commands.json`、`dx/release/`、systemd/container 配置和 runbook。确定：
+- 预期生产环境、品牌、target、服务和前端项目；
+- 预期运行方式，例如 systemd、Docker、Kubernetes、PM2 或 serverless；
+- 部署后可核对版本/commit 的文件、镜像标签、release 目录或运行参数；
+- 数据库、队列、worker、cron、缓存和第三方连接需要验证的范围；
+- 本次发布要求执行或确认的迁移、seed、回填、缓存刷新、配置生成和运维脚本；
+- 发行说明中每个用户可观察变化对应的 smoke check。
 
-- 生产主机、SSH 入口、区域、品牌、服务与前端 target；
-- 服务由 systemd、Docker、Kubernetes、PM2、serverless 或其他方式运行；
-- 服务器上可验证版本/commit 的文件、环境变量、镜像标签、健康接口或运行参数；
-- 数据库、队列、worker、cron、缓存和第三方连接的只读检查入口；
-- 本次发布要求人工执行的迁移、回填、缓存刷新、配置生成或运维脚本。
+仓库未提供生产坐标或验证入口时，在 Issue 中写“待运维按私有配置补充”，不要猜测主机、域名、数据库或历史地址。
 
-逐台登录本次涉及的生产服务器，使用仓库已有状态命令或等价的只读命令检查实际状态。按运行方式核对进程、容器、镜像、release 目录、符号链接、启动时间、health/readiness 和最近日志；命令必须收敛到明确服务，避免无边界扫描整台服务器。
+## Checklist 编写规则
 
-服务器验证默认只读。不要执行重启、重新部署、迁移、回填、数据修复、缓存清空或其他生产写操作；发现需要执行时，在 Issue 和当前回复中写明命令、原因、影响和验证方式，等待用户对该具体动作授权。
+每个检查项都应包含：
 
-如果缺少主机信息、SSH 权限或数据库只读权限，在 Issue 中明确写“生产验证受阻”，附已检查的配置位置和失败命令。此状态属于阻塞，不得写成部署成功。
+- **执行对象**：环境、品牌、target、服务、数据库或业务路径；
+- **预期结果**：可判定通过或失败的状态；
+- **证据要求**：脱敏命令摘要、版本/commit、迁移表结果、日志时间窗、监控链接或可观察行为；
+- **执行时机**：部署前、部署后立即、观察窗口结束后或下一轮 cron 后。
 
-## 动态生成检查项
+不要预填生产结果。Release/tag 已创建等 GitHub 事实可写在“发布信息”中，但不能代替部署与生产检查项。
 
-先从发行说明、提交、PR、Issue、运维提醒和部署配置建立“发布影响面”，再为每个影响面生成至少一个可验证检查。只保留本次适用的分支，但以下类别必须逐项判定是否适用，不能静默跳过。
+### 部署前门禁
+
+- 不可变 tag/commit 与发布计划一致；
+- 品牌 readiness、环境配置和部署矩阵通过；
+- 新增或变更的环境变量、secret、feature flag 和第三方配置已准备；
+- 发布窗口、执行人、观察人、分批策略与回滚入口已记录。
 
 ### 发布与制品一致性
 
-- tag、Release、版本文件和服务器实际运行 commit 指向同一版本；
-- 服务器上的制品、镜像、release 目录或构建产物使用正确版本与 commit；
-- 所有预期生产主机、品牌和 target 都运行目标版本，没有漏发、错发或部分节点仍运行旧版；
-- Release 不是意外的 draft/prerelease，除非版本本身要求如此。
+- tag、Release、版本文件和实际运行 commit 指向同一版本；
+- 服务器制品、镜像、release 目录或前端 deployment 使用正确版本与 commit；
+- 所有预期生产主机、品牌和 target 均已发布，没有漏发或版本漂移；
+- Release 的 draft/prerelease 状态符合版本类型。
 
 ### 服务器与服务状态
 
-- 目标进程、容器、pod 或 function 正常运行，启动时间与本次发布一致；
+- 运维或后续回访 agent 按仓库配置登录每台相关生产服务器；
+- 目标进程、容器、pod 或 function 正常运行，启动时间与本次部署一致；
 - health/readiness、端口、反向代理和服务间连接正常；
 - worker、cron、队列消费者和后台作业运行在目标版本；
-- 最近日志没有启动失败、error、panic、timeout、权限错误或重复重启；
-- CPU、内存、磁盘、连接数等没有因本次发布出现明显异常。
+- 最近日志没有启动失败、error、panic、持续 timeout、权限错误或重复重启；
+- CPU、内存、磁盘、连接数等没有明显异常。
 
 ### 运行时健康与可观测性
 
-- health/readiness、关键进程、容器或 serverless function 健康；
-- 发布后错误率、延迟、5xx、告警、日志异常没有明显回归；
-- 队列积压、定时任务、事件消费、webhook 或后台作业正常；
-- 域名、TLS、静态资源、CDN、缓存版本和 source map 符合预期。
+- 发布后错误率、延迟、5xx、告警和日志异常没有明显回归；
+- 队列积压、定时任务、事件消费、webhook 和后台作业正常；
+- 域名、TLS、静态资源、CDN、缓存版本和 source map 符合预期；
+- 设置适合本次变更的观察窗口和最早复查时间。
 
 ### 数据、配置与兼容性
 
 - 本次迁移已应用到正确数据库，schema 与应用版本兼容；
-- 新增或变更的环境变量、secret、feature flag 和第三方配置已生效；
-- 公共 API、DTO、事件、数据库和客户端兼容性按发行说明验证；
-- 使用有边界的只读查询核对关键总数、不变量、状态分布和抽样结果；不得在输出中泄露密钥、令牌、个人信息或业务敏感原始数据；
-- 涉及数据修复或回填时，记录预期数量、实际数量、失败项和幂等/重跑状态。
+- 新增或变更的运行时配置已生效，敏感值只记录存在性、长度或指纹；
+- 公共 API、DTO、事件、数据库和客户端兼容性得到验证；
+- 使用有边界的只读查询核对关键总数、不变量、状态分布和抽样结果；
+- 数据修复或回填记录预期数量、实际数量、失败项和幂等/重跑状态。
 
 ### 运维脚本执行状态
 
-- 从本次 PR、迁移、release note 和 runbook 列出所有需要人工执行的脚本，不能只检查熟悉的脚本；
-- 对每个脚本记录名称/版本、目标主机或数据库、预期效果和可验证完成标记；
-- 通过迁移表、任务表、审计日志、marker、脚本状态子命令或数据结果判断 `已执行 / 未执行 / 无法确认 / 不适用`；
-- “文件存在”或“有人说跑过”不算执行证据；
-- 未经授权不代替运维执行写脚本。未执行或结果异常时立即报告，并给出建议命令和执行后的复核查询。
+- 从 PR、迁移、release note、runbook 和 ops manifest 列出全部人工脚本；
+- 每个脚本记录名称/版本、目标主机或数据库、预期效果和完成标记；
+- 要求通过迁移表、任务表、审计日志、marker、状态子命令或数据结果判断 `已执行 / 未执行 / 无法确认 / 不适用`；
+- “文件存在”或口头确认不算执行证据；
+- 生产写脚本、迁移、回填、重启或重新部署由运维按授权流程执行，不由 `git-release` 当前调用执行。
 
 ### 用户与业务路径
 
 - 为发行说明中的每个用户可观察变化生成对应 smoke check；
-- 覆盖登录/鉴权、核心读写路径、支付或其他高风险业务路径中本次受影响的部分；
-- 前端、管理端、移动端或多品牌变更分别验证对应入口，不能用一个端的通过代表全部端；
-- 修复项要复现旧失败条件并验证新行为，新增项要验证成功路径和关键错误路径。
+- 覆盖本次受影响的登录/鉴权、核心读写、支付或其他高风险路径；
+- 前端、管理端、移动端和多品牌分别验证，不能用一个端的通过代表全部端；
+- 修复项复现旧失败条件并验证新行为，新增项验证成功路径和关键错误路径。
 
 ### 回滚与延迟观察
 
 - 记录上一稳定版本、回滚命令或恢复入口，以及迁移是否可逆；
-- 对需要时间才能暴露的问题设置观察窗口和最早复查时间，例如错误率、队列积压、定时任务或缓存过期；
-- 明确 Issue 关闭条件：所有必需项完成，阻塞项有结论，发现的问题已修复或拆成关联 Issue。
+- 对错误率、队列积压、定时任务、缓存过期等设置观察窗口；
+- 明确关闭条件：所有必需项完成，阻塞项有结论，发现的问题已修复或拆成关联 Issue。
 
 ## Issue 结构
 
-创建前先读取仓库 Issue 模板和现有 labels，沿用其结构与可用标签。标题使用：
+创建前读取仓库 Issue 模板和现有 labels，沿用其结构与可用标签。标题使用：
 
 ```text
 chore(release): 回访 v<VERSION> 部署结果
@@ -102,17 +126,18 @@ chore(release): 回访 v<VERSION> 部署结果
 - 版本：v<VERSION>
 - Release：<URL>
 - Tag commit：<SHA>
-- 部署环境/品牌/target：<实际范围>
-- 生产服务器与服务：<脱敏主机标识和实际范围>
-- 实际运行版本/commit：<逐目标结果>
-- 生产验证时间：<时间与时区>
-- 验证状态：通过 / 阻塞 / 发现异常
+- 预期部署环境/品牌/target：<从仓库配置得出的范围>
+- 当前状态：待运维执行
 
 ## 部署后检查清单
 
+### 部署前门禁
+
+- [ ] <执行对象、预期结果、证据要求>
+
 ### 发布与制品一致性
 
-- [ ] <检查对象、预期结果、验证命令或证据位置>
+- [ ] <检查项>
 
 ### 生产服务器与服务
 
@@ -124,11 +149,11 @@ chore(release): 回访 v<VERSION> 部署结果
 
 ### 数据、配置与兼容性
 
-- [ ] <检查项或“不适用 + 证据”>
+- [ ] <检查项或“不适用”的判定任务>
 
 ### 运维脚本
 
-- [ ] <脚本、目标、预期结果、执行状态与证据>
+- [ ] <脚本、目标、预期结果与证据要求>
 
 ### 本次变更验收
 
@@ -136,23 +161,16 @@ chore(release): 回访 v<VERSION> 部署结果
 
 ### 回滚与观察窗口
 
-- [ ] <回滚入口已确认>
-- [ ] <观察指标、窗口、最早复查时间、负责人或所需权限>
+- [ ] <回滚入口确认任务>
+- [ ] <观察指标、窗口、最早复查时间和负责人>
 
 ## 发现与后续
 
-- 当前阻塞：无 / <失败证据与恢复动作>
-- 关联问题：无 / #<issue>
-- 关闭条件：<所有必需检查完成且发现的问题有结论>
+- 当前状态：待运维执行
+- 关联问题：无；发现异常后补充
+- 关闭条件：所有必需检查完成且发现的问题有结论
 ```
 
 正文通过 heredoc 或临时文件传给 `gh issue create --body-file`，禁止用字面量 `\n` 拼接。创建后用 `gh issue view <id> --json title,body,url,state` 读回。
 
-## 勾选与问题处理
-
-- 勾选项必须同时写入证据：脱敏命令与结果摘要、日志位置、只读查询汇总、监控链接或具体可观察结果。
-- “服务器能登录”“进程在运行”“页面能开”不能替代版本、脚本和数据的专项验证。
-- 检查失败时保留未勾选状态，在“发现与后续”记录严重级、时间、主机/服务、证据、影响和建议动作，并立即在当前回复中报告。
-- 发现问题后默认只报告和保全证据，不静默修改生产环境。修复需要生产写操作时等待用户对具体动作授权。
-- 新发现的问题超出本次回访可直接修复的范围时创建关联 Issue；回访 Issue 保持打开，直到该问题有明确处置结果。
-- 不适用项必须写出判定依据；不要为了模板完整保留空占位项。
+读回时确认：没有占位符；每个预期生产目标都有检查项；所有部署后检查项仍未勾选；Issue 没有声称已经登录服务器、部署成功或生产健康。

package/skills/oo-ship-issue-pr/SKILL.md

@@ -5,26 +5,9 @@ description: 仅在用户显式调用 $oo-ship-issue-pr、/oo-ship-issue-pr 或
 
 # OO Ship Issue PR
 
-Codex 入口：主进程守门并执行轻改动，Claude Fable 5 优先承接重改动的方案讨论、实现与独立审查；Fable 额度不足时回退 Claude Opus 5，Claude 通道不可用时改派 fresh Codex subagent，不中断交付链。
+Codex 入口：主进程执行轻改动，Claude Fable 5 优先承接重改动的方案讨论、实现与独立审查；Fable 额度不足时回退 Claude Opus 5，Claude 通道不可用时改派 fresh Codex subagent，不中断交付链。
 
-## 步骤一：Codex 门禁
-
-任何文件检查、Git/GitHub 操作或共享流程加载之前执行：
-
-```bash
-if [[ -n "${CLAUDECODE:-}" ]]; then
-  echo "oo-ship-issue-pr 仅允许 Codex 调用；检测到 Claude Code 运行时，已退出。"
-  exit 64
-fi
-if [[ -z "${CODEX_THREAD_ID:-}" && -z "${CODEX_SESSION_ID:-}" ]]; then
-  echo "oo-ship-issue-pr 仅允许 Codex 调用；当前运行时不是 Codex，已退出。"
-  exit 64
-fi
-```
-
-`CLAUDECODE` 存在时优先拒绝，避免 Codex 启动的 Claude 子进程继承 `CODEX_*` 后误过门禁。门禁通过的完成标准是 `CLAUDECODE` 为空，且至少一个 Codex 身份变量非空。
-
-## 步骤二：加载共享流程
+## 步骤一：加载共享流程
 
 ```bash
 AGENTS_ROOT="${AGENTS_HOME:-$HOME/.agents}"