1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | deployment-readiness-harness-harness-skills |
| 作者/维护者 | Harness（harness 官方组织） |
| 来源链接 | https://github.com/harness/harness-skills/tree/main/skills/deployment-readiness |
| 许可证 | Apache-2.0（GitHub API 获取，仓库级） |
| GitHub Stars / Forks | 合集仓库整体 74 / 14（GitHub API 获取；该数字属整个 harness-skills 合集，不代表本技能自身热度，取证方式见第 7 章） |
| 最新版本 | SKILL.md 声明 version 1.0.0 |
| 安装方式 | 克隆仓库 + 配置 Harness MCP v2 Server（详见第 10 章） |
2. 功能介绍与亮点
deployment-readiness 通过 Harness MCP，把“这次能不能上线”这个部署前的关键决策拆成三个可独立触发的工作流。
- 部署就绪检查：拉取流水线健康度（近几次执行通过率、是否所有必需阶段都已通过）、依赖可用性（connector、secret、基础设施是否可达）、制品就绪度（镜像是否存在、是否已过安全扫描、SBOM 是否已生成并签名）、环境健康（是否冻结、有无进行中的事故、资源容量是否充足）、安全门禁（CVE 阈值、OPA 策略、合规证明），逐项给出 PASS/FAIL/WARNING 并汇总为最终 GO/NO-GO 建议
- 环境漂移分析：对比源环境与目标环境在配置、基础设施、secret 版本、Kubernetes manifest、外部依赖上的差异，并按风险分级（CRITICAL 可能导致宕机 / WARNING 可能导致行为差异 / INFO 无实质影响）
- 金丝雀发布决策：对比金丝雀版本与基线版本的错误率、延迟（P50/P95/P99）、吞吐量、资源占用与业务指标，给出 PROMOTE / HOLD / ROLLBACK 建议
- 三个工作流共享同一套只读 MCP 工具（
harness_list、harness_get），不修改任何流水线或资源；文档明确要求漂移分析要“贴近部署时刻”执行、金丝雀判断需要足够流量样本才有统计意义，属于对实践细节有具体交代的文档，而非泛泛而谈
3. 适用场景
所属分类：DevOps 与基础设施
适合已经在用 Harness CI/CD 的工程师与 SRE：把上线前“流水线是不是都跑通了”“这次配置和线上环境有没有差异”“金丝雀该继续放量还是回滚”这几件容易靠人工拍板、又经常因为疏漏引发事故的判断，交给 agent 通过只读 MCP 工具拿到结构化的 PASS/FAIL/WARNING 报告与明确建议，尤其适合团队里还在靠个人经验做上线判断、缺乏统一检查清单的初中级工程师。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库根目录 CLAUDE.md 导入 AGENTS.md，skills 自动发现，README 给出具体安装步骤
- Codex：官方支持——README 明确列出 Codex 的 MCP 配置步骤（
AGENTS.md自动作为系统指令加载，并可在 prompt 中直接引用具体技能文件） - OpenClaw：未验证——抓取材料未点名，仅笼统声明支持任何兼容系统指令/MCP/文件上下文的 AI 工具
- Hermes Agent：未验证——抓取材料未点名，理由同上
5. 推荐理由
把上线前最容易靠人工拍板、也最容易因疏漏引发事故的三件事——流水线是否真的就绪、目标环境和源环境有没有偷偷漂移、金丝雀该放量还是回滚——统一成结构化的 GO/NO-GO 判断，让团队有一套可复用的上线检查清单，而不是依赖某个工程师的个人经验。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Harness 官方出品，但本子技能自身仅 1 次提交，仓库整体规模有限，未见独立于官方渠道的第三方讨论 |
| 可用性 | 7 | 三个工作流的步骤、检查项与响应模板均写得清楚，官方文档站也将其列为正式（非 Alpha）技能；但自 2026-05-22 批量添加后未见后续迭代提交，且需要已配置好的 Harness 账号、MCP v2 Server 与 API Key，非零配置开箱即用 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 7.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 不执行任意 shell 命令，全部通过 harness_list/harness_get 只读 MCP 工具完成查询，不修改任何流水线、环境或资源 |
| ② 联网外发 | 仅通过用户自行配置的 Harness MCP v2 Server 与用户自己的 Harness 账号通信，未见其他外发目标 |
| ③ 凭据存储 | 依赖 Harness MCP Server 自身的 API Key 配置（环境变量），技能正文不要求粘贴或落盘明文凭据 |
| ④ 可疑指令 | 全文未发现提示注入或隐蔽指令，均为检查步骤说明与响应格式模板 |
| ⑤ 作者信誉 | Harness 为知名商业 CI/CD 平台厂商，harness 为其官方 GitHub 组织 |
| ⑥ License | Apache-2.0，明确（仓库级） |
| ⑦ 维护时间 | 子目录自身仅 1 次提交（2026-05-22），仓库整体最近一次提交为 2026-07-07，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| deployment-readiness（本技能） | 面向已用 Harness 平台的团队，在部署前一次性完成就绪检查、环境漂移分析、金丝雀发布决策三件事 | 深度整合 Harness 平台内部状态（流水线执行、connector、secret、环境配置），判断依据是平台实时数据而非本地文件 |
| all-deploy（Hainrixz 出品） | 面向单个开发者的本地到生产部署工具，7 阶段流程覆盖前置检查、安全审计、预览部署、健康验证、生产提升，支持 Vercel/Railway/Docker+SSH/cloudflared 四类目标 | 不绑定任何 CI/CD 平台，直接由开发者在本地触发部署本身；检查项聚焦代码仓库卫生（密钥泄露、.gitignore、依赖锁文件），无环境漂移对比与金丝雀发布决策能力 |
| debug-pipeline（同仓库姊妹技能） | 流水线执行失败后的事后诊断，定位阶段/步骤级根因并给出修复建议 | 是“出问题之后”的排查工具，而非部署前的预防性门禁 |
| enforce-sbom（同仓库姊妹技能） | 把 SBOM 合规门禁强制插入流水线的单一步骤 | 只覆盖供应链合规这一项检查，不做流水线健康、环境漂移或金丝雀指标的综合判断 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；仓库层面公开的 issue 与合并记录以 Harness 内部工程师为主，唯一一条外部 issue 与本技能无关。
9. 其他补充
除 Claude Code、Codex 外，README 同时给出 Cursor 与 GitHub Copilot 的接入步骤（分别通过 mcp.json 配置与 copilot-instructions.md）。同仓库还有 debug-pipeline（流水线失败根因诊断）、dora-metrics（团队交付效能报告）、create-sbom / sign-artifact / verify-sign / enforce-sbom（供应链安全组）等技能，deployment-readiness 的安全门禁检查项与后者形成呼应，共同覆盖“生成合规制品 → 部署前拦截不合规 → 上线前综合判断”的流程。
10. 安装使用方式
git clone https://github.com/harness/harness-skills.git
cd harness-skills
claude在 ~/.claude/settings.json 中加入 Harness MCP v2 Server 配置：
{
"mcpServers": {
"harness-mcp-v2": {
"command": "npx",
"args": ["-y", "harness-mcp-v2"],
"env": { "HARNESS_API_KEY": "<your-api-key>" }
}
}
}安装后无需重启；在对话中输入 /deployment-readiness 或直接描述“这个服务能不能部署到生产”“对比一下 staging 和 production 环境”“金丝雀该继续放量还是回滚”即可触发对应工作流。
11. 注意事项
- 必须已有 Harness 账号并配置好 Harness MCP v2 Server（含 API Key），无法离线或脱离 Harness 平台使用
- 环境漂移分析建议紧贴部署时刻执行，提前太久跑可能漏掉临近的变更
- 金丝雀发布决策需要足够的流量样本才有统计意义，低流量服务可能需要更长的观察窗口
- OpenClaw / Hermes Agent 的兼容性未见官方声明，跨 agent 使用前建议自行验证