mcpField
A
alpha-forge-preship

alpha-forge-preship

github.com/terrylica测试与质量292 次安装1 天前更新
代码仓库

关于 alpha-forge-preship

alpha-forge-preship 是用于 Alpha Forge PR 审查周期的质量检查技能，面向开发与审查流程。它通过四个门禁检查 RNG 确定性、URL、参数和清单同步。

主要功能

  1. 01检查 RNG 隔离与确定性
  2. 02验证 Fork URL
  3. 03检查参数范围
  4. 04核对装饰器与 YAML 清单

适用场景

  1. 01在提交前检查 RNG 与 URL
  2. 02在运行时或 CI 验证参数
  3. 03在 CI 中检查清单同步

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill alpha-forge-preship

安装后在 Claude Code 中输入/alpha-forge-preship确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
gates/
__init__.py
g1_documentation_scope.py
g10_performance_red_flags.py
g12_manifest_sync.py
g2_documentation_clarity.py
g3_documentation_completeness.py
g4_url_validation.py
g5_rng_determinism.py
g6_warmup_alignment.py
g7_parameter_documentation.py
g8_parameter_validation.py
references/
evolution-log.md
reference.md
tests/
__init__.py
test_g1_documentation_scope.py
test_g10_performance_red_flags.py
test_g12_manifest_sync.py
test_g2_documentation_clarity.py
test_g3_documentation_completeness.py
test_g4_url_validation.py
test_g5_rng_determinism.py
test_g6_warmup_alignment.py
test_g7_parameter_documentation.py
test_g8_parameter_validation.py
test_gates.py

详细介绍

Alpha Forge 发货前质量门禁 - 第 1 阶段

用于 Alpha Forge PR 审查周期的质量保障插件。

自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生偏移，或需要采用变通方案，请立即修复此文件，不要推迟。仅针对真实且可复现的问题进行更新。

概述

实施 4 项可靠的质量门禁，以捕获 PR #154 的 13 个问题中的 5 个：

  • G5：RNG 确定性（提交前）
  • G4：URL 分叉验证（提交前）
  • G8：参数验证（运行时/CI）
  • G12：清单同步验证（CI）

效果

  • 问题预防率：42% 的 PR 问题
  • 误报率：<1%
  • 实施时间：约 4 小时
  • 回本周期：2-3 个 PR
  • 审查周期缩短：30-50%

关键文件

  • gates/g5_rng_determinism.py - RNG 隔离验证器
  • gates/g4_url_validation.py - 分叉 URL 检测器
  • gates/g8_parameter_validation.py - 参数范围验证器
  • gates/g12_manifest_sync.py - 装饰器与 YAML 同步验证器
  • orchestrator.py - 主验证器协调器
  • reference.md - 完整框架文档

架构

所有门禁均遵循装饰器作为唯一事实来源原则：

  • 在装饰器中定义参数约束
  • 在入口点验证配置
  • 自动确保清单一致性
  • 系统化地执行文档要求

集成

提交前钩子
from gates.g4_url_validation import validate_org_urls
from gates.g5_rng_determinism import validate_rng_isolation
运行时参数验证
from gates.g8_parameter_validation import ParameterValidator
validator = ParameterValidator()
validator.validate_numeric_range(value, min_val, max_val)
清单验证
from gates.g12_manifest_sync import validate_manifest
issues = validate_manifest("manifest.yaml")

参考资料

  • 主手册：/tmp/CANONICAL_PRESHOP_AUDIT_HANDBOOK.md（523 行）
  • 实施计划：/tmp/PHASE_1_IMPLEMENTATION_PLAN.md（367 行）
  • 项目摘要：/tmp/PROJECT_COMPLETION_SUMMARY.md

状态

✅ 第 1 阶段已完成 - 可合并至 cc-skills，并与 alpha-forge 集成

执行后反思

此技能完成后，关闭前请检查：

  1. 命令是否成功？ — 如果没有，请修复导致失败的说明或错误表。
  2. 参数或输出是否发生变化？ — 如果底层工具的接口发生偏移，请更新用法示例和参数表，使其保持一致。
  3. 是否需要采用变通方案？ — 如果你不得不临时变通（使用不同的标志、增加额外步骤），请更新此 SKILL.md，确保下次调用不必重复采用相同的变通方案。

仅在问题真实且可复现时进行更新，不要基于猜测更新。

评论

支持 Markdown