用途
Enterprise 是 bkit-claude-code 中的高级(企业级)技能,面向高级开发者、CTO/架构师以及大规模系统运维人员,用于构建企业级系统,覆盖微服务、Kubernetes、Terraform 与 AI Native 方法论,适合跨越发布周期的多特性项目。
主要能力
该技能提供三类操作:
- init:项目初始化,命令为
/enterprise init my-platform(即/init-enterprise feature)。会创建 Turborepo 单仓结构(apps/、packages/、services/、infra/ 目录)、生成 CLAUDE.md(级别指定为 Enterprise)、建立 docs/ 五分类结构、生成 infra/terraform/ 与 infra/k8s/ 基础模板,并初始化 pipeline store——在 lib/pdca/status.js 中调用 writeBkitMemory(),写入 .bkit/state/memory.json(.bkit-memory.json 的迁移路径)。该文件保存项目级别与 9 阶段 pipelineStatus,供第 5、6、9 阶段的 pipeline Stop hooks 读取;PDCA 阶段本身不在此文件,而在 .bkit/state/pdca-status.json。 - guide:显示开发指南,命令为
/enterprise guide,内容包括 AI Native 10 天开发周期、微服务架构模式、第 1-9 阶段完整 Pipeline(企业版)。 - help:MSA/基础设施帮助,命令为
/enterprise help,内容包括 Kubernetes 基本概念、Terraform IaC 模式、AWS EKS 与 RDS 配置指南。
技术栈
前端:Next.js 14+(Turborepo 单仓)、TypeScript、Tailwind CSS、TanStack Query、Zustand、Sentry Browser SDK(@sentry/nextjs,错误追踪 + Session Replay)。
后端:Python FastAPI(微服务,默认)、PostgreSQL(schema 分离)、Redis(缓存、Pub/Sub)、RabbitMQ / SQS(消息队列)、Sentry Server SDK(sentry-sdk[fastapi],错误追踪 + APM)。
基础设施:AWS(EKS、RDS、S3、CloudFront)、Kubernetes(Kustomize)、Terraform(IaC)、ArgoCD(GitOps)、ALB + NGINX Ingress Controller(L7 负载均衡,CORS 通过 Ingress annotation 处理,NLB(L4)仅用于 gRPC/WebSocket 专用服务)。
CI/CD:GitHub Actions、Docker、Semgrep(SAST)+ Trivy(容器扫描)。
监控与错误追踪:Sentry(错误追踪、分组、回归检测)、Prometheus + Grafana(指标与仪表盘)、Loki + Promtail(日志聚合)、Tempo + OpenTelemetry(分布式追踪)、Alertmanager → PagerDuty(严重)/ Slack(警告)。
自愈流水线:Sentry Webhook → Self-Healing Agent 触发、4 层 Living Context(Scenarios、Invariants、Impact、Incidents)、自动修复(最多 5 次迭代)→ 自动 PR → 金丝雀部署、错误率飙升时自动回滚。
语言层级指引(v1.3.0)
支持所有层级,企业级可处理包括遗留系统集成在内的复杂需求。Tier 1 主服务用于新开发与核心功能;Tier 2 系统/云使用 Go(K8s)、Rust(性能关键);Tier 3 平台原生使用 iOS(Swift)、Android(Kotlin)、遗留 Java;Tier 4 遗留集成需要迁移计划。迁移路径:PHP → TypeScript(Next.js API routes)、Ruby → Python(FastAPI)、Java → Kotlin 或 Go。
项目结构
项目包含 apps/(web、admin、docs)、packages/(ui、api-client、config)、services/(auth、user、{domain}、shared)、infra/(terraform 的 modules 与 environments、k8s 的 base 与 overlays)、docs/(00-requirement、01-development、02-scenario、03-refactoring、04-operation)、scripts/、.github/workflows/、docker-compose.yml、turbo.json、pnpm-workspace.yaml。
架构与模式
采用 Clean Architecture 四层:API 层(FastAPI routers、请求/响应 DTO、认证授权中间件)、Application 层(Service 类、用例实现、事务管理)、Domain 层(纯 Python 实体类、ABC 仓库接口、业务规则)、Infrastructure 层(SQLAlchemy 仓库实现、外部 API 客户端、缓存与消息、Sentry SDK 集成)。依赖方向自上而下,Domain 层不依赖任何层。
核心模式包括 Repository Pattern(接口与实现分离)与跨服务通信(同步内部 API 使用 httpx 与 X-Internal-Token,异步使用消息队列发布)。还提供 Terraform 模块(如 aws_eks_cluster)与 Kubernetes Deployment 示例。
环境配置与安全
环境分为 Local(Docker Compose,手动部署)、Staging(EKS,ArgoCD 自动同步)、Production(EKS,ArgoCD 手动同步)。安全规则允许从 Secrets Manager 获取密钥、基于 IAM 角色的访问、VPC 内部通信、服务间 mTLS;禁止硬编码密钥、数据库置于公有子网、使用 root 账户、过度 IAM 权限。
CI/CD 与 SoR 优先级
CI/CD 流程:推送 feature/* → GitHub Actions(Lint、Test、构建 Docker 镜像、推送 ECR)→ PR 到 staging → ArgoCD 自动同步(Staging)→ PR 到 main → ArgoCD 手动同步(Production)。
SoR 优先级:第一优先为代码库(scripts/init-db.sql 为数据库 schema 的事实来源,services/{service}/app/ 为各服务实现);第二优先为 CLAUDE.md/约定文档(services/CLAUDE.md、frontend/CLAUDE.md、infra/CLAUDE.md);第三优先为 docs/ 设计文档(用于理解设计意图,若与代码不同以代码为准)。
AI Native 开发
三大核心原则:文档优先设计(先写设计文档再写代码)、单仓上下文控制(所有代码在一个仓库便于 AI 理解上下文)、基于 PR 的协作(每次变更都通过 PR)。10 天开发模式:第 1 天架构(市场分析 + 系统架构)、第 2-3 天核心(认证、用户 + 业务服务)、第 4-5 天 UX(PO 反馈 → 文档 → 实现)、第 6-7 天 QA(Zero Script QA + 缺陷修复)、第 8 天基础设施(Terraform + GitOps)、第 9-10 天生产(安全审查 + 部署)。单仓优势:AI 理解完整上下文、类型单一事实来源、跨层原子提交、强制一致模式。CLAUDE.md 层级规则:区域特定 CLAUDE.md 覆盖项目级规则。
bkit 企业级特性(v1.5.1)
输出风格:推荐使用 bkit-enterprise,通过 /output-style bkit-enterprise 激活,提供架构权衡分析表(Option/Pros/Cons/Recommendation)、每个决策的性能/安全/可扩展性视角、基础设施变更的成本影响估算、部署策略建议(Blue/Green、Canary、Rolling)、SOLID 原则与 Clean Architecture 合规检查。
Agent Teams(4 名队友):architect(enterprise-expert、infra-architect,Design 阶段)、developer(bkend-expert,Do、Act 阶段)、qa(qa-monitor、gap-detector,Check 阶段)、reviewer(code-analyzer、design-validator,Check、Act 阶段)。启用方式:设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1,启动团队模式 /pdca team {feature},监控进度 /pdca team status。
Agent Memory(自动激活):所有 bkit agent 自动跨会话记住项目上下文,企业级 agent 使用项目范围记忆,确保架构决策与基础设施模式跨开发会话持久化。
适用场景与限制
适用于企业级多特性项目、微服务架构、需要 Kubernetes/Terraform/GitOps 的云原生部署,以及需要 AI Native 开发流程与自愈流水线的团队。限制方面:资料未提供收费、价格、平台兼容性等具体信息;部分能力(如 Agent Teams)需设置实验性环境变量;语言层级中 Tier 4 遗留集成需要迁移计划。