核心定位
gcp-fullstack 是一款面向 Google Cloud Platform 的全生命周期开发超级智能体，将传统需要多团队协作的架构设计、开发、测试、部署、运维工作流整合为单一可调用技能。该工具由资深全栈工程师与 GCP 架构师角色驱动，覆盖从项目脚手架到生产监控的完整 DevOps 闭环。
核心能力与显著优势
1. 智能服务选型决策树
内置经过实战验证的计算（Cloud Run/Functions/App Engine）、数据库（Firestore/Cloud SQL/Spanner）、认证（Firebase Auth/Identity Platform）三层决策矩阵。自动根据项目特征推荐最优架构组合，避免常见的过度设计或资源错配。
2. 强制规划协议（Planning Protocol）
执行任何操作前必须完成七步规划：需求澄清、环境勘察、服务选型、执行计划、风险识别、顺序执行、结果汇总。该机制显著降低"盲目执行导致的配置漂移或数据丢失"风险，特别适合生产环境的敏感操作。
3. 完整功能垂直切片生成
不仅生成骨架代码，而是产出包含 Schema 设计、数据访问层、API 路由、Server Actions、UI 组件、Toast 通知、加载/错误状态的完整功能模块，真正实现"描述需求即得可运行代码"。
4. 企业级预生产 QA 门禁
内置10步验证工作流：测试计划生成 → 现有测试套件执行 → 专项验证测试生成（API/UI/Auth/LLM/基础设施） → 聚合报告 → Go/No-Go 判决。特别包含针对 LLM 输出的双层质量评估（规则检查 + LLM-as-Judge），以及 GCP 基础设施只读健康检查。
5. Cloudflare 深度集成
原生支持通过 Cloudflare API v4 自动配置 DNS、CDN、SSL/TLS、速率限制、缓存清除及 Bot 防护，实现从应用到边缘安全的完整覆盖。
潜在局限与风险考量
- Docker 硬性依赖：v2.0 版本要求本地 Docker 环境，对纯 Cloud Functions 场景可能造成资源开销
- 凭证管理边界：明确声明不直接操作
.env或凭证文件，需用户预配置GOOGLE_APPLICATION_CREDENTIALS、CLOUDFLARE_API_TOKEN等环境变量 - OpenRouter 可选依赖：LLM-as-Judge 功能需要
OPENROUTER_API_KEY，缺失时降级为"人工复核"模式 - GCP 锁定效应：深度优化 GCP 服务选型，跨云迁移需重新评估架构
- 模块文档依赖：执行各阶段前需读取对应子文档，网络或文件缺失可能导致执行中断
适用人群
- 技术创始人/全栈独立开发者：需要一人完成从 0 到 1 的完整产品交付
- 中小型技术团队：缺乏专职 DevOps/SRE，需要标准化、可重复的部署流程
- 企业数字化团队：需要符合云原生最佳实践、内置合规检查（SSL 强制、备份验证、密钥轮转）的标准化开发流程
- AI 辅助开发实践者：寻求超越代码补全的"端到端需求实现"能力边界
安全与可信度评估
| 维度 | 评估 |
|:---|:---|
| **操作安全** | 明确区分读写权限，QA 阶段所有 `gcloud` 命令限定为只读（describe/list）；强制规划协议降低误操作风险 |
| **凭证处理** | 从不直接读取或修改 `.env`、凭证文件；所有密钥引用通过环境变量透传，报告生成时自动脱敏 |
| **基础设施风险** | 部署前 Go/No-Go 门禁阻止带病上线；基础设施健康检查覆盖 SSL 强制、备份状态、密钥完整性 |
| **审计可追溯** | 标准化报告输出（JSON + Markdown 双格式），支持版本追溯与合规审计 |
版本演进亮点
v2.0.0 完成从"工具集"到"工作流引擎"的跃迁：整合 v1.x 分散的 scaffold/deploy/database 技能；引入强制规划协议；分离独立 qa-gate-gcp 技能；强化 Docker 与 Cloudflare 集成。现有 v1.x 项目代码完全兼容，无需迁移成本。