AI-Native CI/CD

验证 AI-Agent 驱动的高速开发、协作与 CI/CD 工作流的实验性仓库。

架构概览

main          ← 保护分支，生产环境，仅接受 Release PR
  └── develop ← 保护分支，所有 feature 汇聚，自动部署 Test 环境
        ├── feature/cc-{task-id}-{slug}   🤖 Claude Code 专属
        ├── feature/gm-{task-id}-{slug}   ✨ Gemini 专属
        ├── fix/cc-{task-id}-{slug}
        └── fix/gm-{task-id}-{slug}

模块归属

模块	路径	负责 Agent
库存管理	src/modules/inventory/	🤖 Claude Code
供应商管理	src/modules/supplier/	🤖 Claude Code
订单处理	src/modules/order/	✨ Gemini
需求预测	src/modules/forecasting/	✨ Gemini
基础设施	src/shared/, .github/	👤 Human

GitHub Actions 流水线

Workflow	触发条件	功能
ci-feature.yml	push 到 feature/* / fix/*	Lint + 单元测试 + 覆盖率
conflict-detector.yml	PR 打开/更新	双 Agent 文件冲突预警
ai-review.yml	CI 通过后自动触发	Gemini 自动 Code Review
cd-develop.yml	push 到 develop	SSH 部署到 Test 环境
branch-cleanup.yml	每日 02:00 UTC	过期分支打 stale 标签
cd-production.yml	推送 v*.*.* tag	蓝绿部署到生产 + GitHub Release

快速开始

# 安装依赖
npm install

# 本地启动
npm run dev

# 运行测试
npm test

# 代码检查
npm run lint

API 端点

GET  /health                        健康检查
GET  /api/inventory                 库存列表
GET  /api/inventory/alerts          低库存预警
POST /api/inventory                 新增库存项
GET  /api/suppliers                 供应商列表
GET  /api/suppliers/best            最优供应商
POST /api/suppliers                 新增供应商
GET  /api/orders                    订单列表
GET  /api/orders/stats              订单统计
POST /api/orders                    创建订单
PATCH /api/orders/:id/status        更新订单状态
GET  /api/forecasting/:sku          需求预测
GET  /api/forecasting/skus          可预测 SKU 列表

AI Agent 工作规范

分支命名

feature/cc-001-inventory-reorder    # Claude Code feature
feature/gm-001-order-status-api     # Gemini feature
fix/cc-002-supplier-timeout         # Claude Code fix
fix/gm-002-forecast-accuracy        # Gemini fix

Commit 规范

feat(inventory): [CC] 添加库存预警自动触发补货逻辑
fix(supplier): [CC] 修复供应商 API 超时重试不生效问题
feat(order): [GM] 实现订单状态机完整转换逻辑
test(forecasting): [GM] 补充移动平均算法边界测试

GitHub Secrets 配置

Secret	用途
SSH_PRIVATE_KEY	CD 部署用 SSH 私钥
DEPLOY_HOST	Test 环境服务器 IP
DEPLOY_USER	SSH 登录用户
DEPLOY_PATH	部署目录路径
PROD_HOST	生产环境服务器 IP
PROD_PATH	生产部署目录
GEMINI_API_KEY	AI Code Review API Key