SuperAPI AI 工具集

contributing

编程与开发

查看项目

更新于 10-16 05:49

技能介绍

用途:为 Cloud Foundation Fabric(GCP Terraform 蓝图仓库)定义端到端贡献流程,支持两种入口。模式 A 从 Issue 分类开始,处理已分配或上报的 GitHub Issue;模式 B 直接做功能开发、重构或准备 PR,从设计签核关卡进入。模式不明确时应先询问用户。

主要能力:设置人工关卡(Human-in-the-Loop Gate),包括 Triage 处置、设计签核、E2E 选入、行为验证选入、PR 审核;机械可逆步骤(lint、测试、文档与清单再生成)保持自动。流程步骤为:分类 Issue、开发修复或功能、测试与 lint 及清单再生成、提交前自审、可选的云上 E2E 验证、提交净化后的 PR。

必要用法:用 gh issue view <issue-number> 查看 Issue;检索 Terraform Google provider 文档,注意仓库在 default-versions.tf 固定 provider 版本,升级须用 uv run tools/versions.py --provider-min-version <x.y.z> --write-defaults 全仓库传播;分支命名如 git checkout -b <username>/<feature-name>;遵循 CONTRIBUTING.md 与 GEMINI.md 约定:变量与输出按字母序、行宽 79 字符、context 插值、ENUM 变量加 validation、集合用 map、私有 locals 前缀 _。工厂相关模块变更须更新 schema 并运行 uv run tools/schema_docs.py。

测试与校验:uv run --with-requirements tools/requirements.txt tools/lint.sh;uv run tools/check_documentation.py modules/<module-name> 与 uv run tools/tfdoc.py --replace modules/<module-name>;用 TF_PLUGIN_CACHE_DIR=/tmp/tfcache uv run --with-requirements tests/requirements.txt pytest tests/modules/<module_name> 及 pytest -k 'modules and <module-name>:' tests/examples。清单再生成用 uv run tools/generate_plan_summary.py,注意 --save 会覆盖断言基线,须 git diff 核对并报告。

限制:E2E 需提供沙箱项目 ID 作为授权;非交互运行时遇关卡无答复必须停止,不得假设批准;不得自行评论、加标签或关闭 Issue。原文在 Step 5 处截断,后续步骤细节暂未提供。