SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场production-parity-skill-builder

production-parity-skill-builder

部署与运维

查看项目

更新于 10-16 11:30

技能介绍

用途

Production Parity Skill Builder 用于为某一个具体应用构建可复用的“生产一致性技能”。该技能的目标是让本地及非生产环境在行为上与生产环境保持一致，同时把每一处有意的差异显式记录并加以测试。

生产环境是参考契约。本地、CI、PR、预览和预发环境可以使用更轻量的基础设施，但它们必须模拟生产行为，或者通过补偿性测试记录差异。例如，生产环境要求 authentik 组限制而本地没有，这是一致性缺陷，而不是无害的便利。

主要能力

  • 在提问之前先检查仓库，从文档、应用代码、测试、本地设置、CI 与预览、基础设施、生产描述符中收集证据。
  • 构建一致性地图，记录每个表面的生产真相来源、非生产表示、漂移风险、当前防护、修复模式以及负责人或升级路径。
  • 仅针对源码无法回答的决策提出有针对性的问题，优先使用结构化选项，并推荐最安全的选项。
  • 为特定应用生成技能，通常命名为 <app-name>-production-parity，并存储在目标应用仓库内。
  • 生成的技能包含：应用一致性契约、生产真相来源、检查工作流、一致性表面、漂移检查、修复模式、问题协议和输出契约。
  • 指定目标应用所需的防护措施，例如配置一致性、认证一致性、夹具一致性、基础设施一致性、提供商一致性、运行时一致性和冒烟一致性。
  • 在获得授权后才实施一致性修复；仅创建技能本身不授权修改应用或基础设施。
  • 验证生成的技能，确认每条应用特定声明都有仓库来源或用户回答支撑，且技能路径位于目标应用仓库内。

使用方式

  1. 检查仓库：使用 rg --files 和针对性 rg 搜索，检查文档、应用代码、测试、本地设置、CI 与预览、基础设施、生产描述符。搜索环境名称和一致性敏感术语，例如 prod|production|staging|preview|pr|local|dev|ci|docker|compose|k8s|helm|terraform|pulumi|auth|oidc|saml|jwt|group|role|claim|permission|feature flag|secret|env|webhook|cron|queue|seed|fixture|migration。
  2. 构建一致性地图：为每个表面记录生产真相来源、非生产表示、漂移风险、当前防护、修复模式、负责人或升级路径。可加载 resources/parity-surface-catalog.md 作为检查清单。
  3. 提出有针对性的问题：在检查之后，仅提出会改变生成技能或所需修复的问题。使用当前 harness 可用的提问设施，如 AskUserQuestion、request_user_input、ask_question 或等效工具；如果没有结构化提问工具，则使用简洁的纯文本问题。可加载 resources/question-patterns.md 获取可复用的问题形式。
  4. 生成应用特定技能：通常命名为 <app-name>-production-parity，存储在目标应用仓库内。不要创建在用户/全局文件夹中，例如 ~/.agents/skills、~/.codex/skills、~/.claude/skills 或 $CODEX_HOME/skills。根据应用仓库选择项目本地位置：如果已有项目本地技能目录，沿用该约定；优先 .claude/skills/<app-name>-production-parity/SKILL.md 或 .codex/skills/<app-name>-production-parity/SKILL.md；如果没有项目本地技能约定，先提出一个简洁的 harness 问题；如果只有全局/用户技能目录，不要使用它们，询问技能应放在项目仓库的哪里。可从 resources/generated-skill-template.md 开始，删除无关部分并用应用特定证据替换占位符。
  5. 指定防护措施；仅在获得授权后添加：生成的技能应列出目标应用所需的窄范围检查，例如配置一致性、认证一致性、夹具一致性、基础设施一致性、提供商一致性、运行时一致性、冒烟一致性。当差异是有意为之，要求给出具名理由和补偿性防护。仅在用户明确要求一致性修复或授权额外变更后，才在应用代码、测试、配置、夹具或基础设施中实施这些检查。
  6. 验证生成的技能：重新阅读生成的技能，确认每条应用特定声明都有仓库来源或捕获的用户回答；确认没有不适用的通用检查项；确认技能路径位于目标应用仓库内；运行 harness 或仓库中可用的技能验证命令；如果无法运行验证，说明具体原因。

适用场景

  • 当本地、CI、PR、预览、预发或其他非生产环境可能与生产行为发生漂移时。
  • 当仅生产环境存在的认证、配置、身份提供商组、功能标志、基础设施、后端服务或策略差异导致过缺陷时。
  • 当团队希望获得一个可复用的技能，用于检测、记录、测试并帮助修复某一个具体应用的一致性漂移时。

限制

  • 该工具为特定应用生成技能，不提供通用的一致性报告作为最终产品。
  • 仅创建技能本身不授权修改目标应用或基础设施；实施修复需要用户明确授权。
  • 生成的技能必须存储在目标应用仓库内，不能存储在用户/全局技能文件夹中。
  • 如果仓库证据无法在模拟器、本地服务、托管沙箱或测试工具之间做出重要选择，应通过 evaluate-existing-solutions 路由已知的一致性契约和约束，而不是让工具搜索定义生产保真度。
  • 资料中未提供具体的收费、价格、平台支持范围或效果保证信息。