🚀 Amazing

企业级 AI Coding 脚手架框架

一条命令初始化企业级项目 · 完整规范体系 · 全栈监控 · AI 协同开发

🤖 AI 原生 📋 规范完整 📊 监控完善 🧠 技能复用 🔐 权限治理 📦 开箱即用 🔄 任务拆分
GitHub 快速开始 架构设计
11
核心 Agent
7
固定角色
40+
工作流
23
Skill 技能
9
业务流程
4
规范体系

💎 核心能力

🏗️ 架构驱动

基于 9 大业务流程：产品分析 → 技术架构 → 代码开发 → 测试 → 部署 → 运营 → 审查 → Bug 修复 → 进化

🤖 AI 原生

11 个核心 Agent + 7 个固定角色 + 动态业务 Agent + Handoffs 引擎，实现完整的 AI 协同开发

📋 规范完整 NEW

内置代码/Git/API/测试完整规范体系，支持 Python/TypeScript，自动化检查

📊 监控完善 NEW

内置 Monitoring Agent（日志/指标/追踪/告警），实现全栈可观测性

🧠 技能复用 NEW

23 个 Skill 技能库，覆盖架构/开发/数据库/测试/运维/安全/运营 8 大分类，按角色权限加载

🔐 权限治理

每个角色独立的 IronClaw 实例，严格的权限边界、约束规则和工作流

📦 开箱即用

初始化即部署就绪：本地开发 / Docker Compose / Kubernetes / 离线私有化

🏛️ 完整架构

📋 规范层 (Standards) NEW

统一的开发规范体系，支持自动化检查

代码规范 (Python/TypeScript) Git 工作流 (Git Flow + Conventional Commits) API 设计 (RESTful + OpenAPI 3.0) 测试规范 (测试金字塔 + 覆盖率)

👥 角色层 (Roles) ENHANCED

7 个固定角色，每个角色包含完整的定义、约束和工作流

架构师 (3 文件: role/constraints/workflows) 产品经理 (3 文件) 前端开发 (3 文件) 后端开发 (3 文件) 测试工程师 (3 文件) 运维工程师 (3 文件) 运营人员 (3 文件)

🤖 Agent 层 (11 个核心 Agent)

框架核心 Agent (6 个)

Common Agent (通用模块) Review Agent (代码审查) Architect Agent (架构设计) Database Agent (数据库管理) Deployment Agent (部署管理) Evolution Agent (进化管理)

监控 Agent (1 个) NEW

Monitoring Agent (日志/指标/追踪/告警)

业务 Agent (4 个模板，按需选择) NEW

Compute Agent (算力平台) Data Agent (数据平台) Training Agent (训推平台) Model Service Agent (模型服务)

🧠 Skill 层 (23 个技能) NEW

可复用的方法论和规范库，按角色权限加载，供 Agent 和 Handoff 调用

架构设计: architecture-design / tech-selection / api-design 开发: react-component / state-management / microservice / auth-implement 数据库: database-design / db-migration / query-optimization 测试: test-design / test-automation / performance-test 运维: docker-deploy / k8s-deploy / ci-cd-pipeline / monitoring-setup 安全: security-audit / code-review-checklist 运营: data-analysis / config-management 初始化: init-project

Commands：/init-role 加载角色技能 · /switch-tool 切换 AI 工具链

🔧 Sub-Agent 层 (29+ 个)

每个核心 Agent 包含 4-5 个专业 Sub-Agent

Common: auth/gateway/notification/config/orchestrator Review: code-review/security/style/perf/orchestrator Architect: design/tech-selection/decision/orchestrator Database: schema/migration/adapter/query/orchestrator Deployment: docker/k8s/ci-cd/env/orchestrator Evolution: analyzer/tracker/notifier/learner/orchestrator Monitoring: log/metrics/trace/alert/orchestrator

🔄 Handoffs 层 (9 条链)

完整的业务流程链，防止上下文溢出

1. 产品分析链 2. 技术架构链 3. 代码开发链 4. 测试链 5. 部署链 6. 运营链 7. 审查链 8. Bug 修复链 9. 进化链

🔐 权限层 (IronClaw)

每个角色独立的权限实例，严格的权限边界

7 个角色实例 权限矩阵 审批流程 审计日志

🎁 生成的项目具备的能力

1. 完整的规范体系 NEW

  • 代码规范：Python (PEP 8) + TypeScript (Airbnb Style Guide)
  • Git 规范：Git Flow + Conventional Commits + PR 流程
  • API 规范：RESTful 设计 + OpenAPI 3.0 文档
  • 测试规范：测试金字塔 + 覆盖率要求 (单元 > 80%, 集成 > 60%)
  • 自动化检查：ESLint/Prettier/Black/Ruff/Pytest

2. 全栈监控能力 NEW

  • 日志管理：ELK Stack / Loki + 日志格式规范
  • 指标监控：Prometheus + Grafana + RED/USE 方法
  • 链路追踪：Jaeger / Tempo + OpenTelemetry
  • 告警管理：Alertmanager + 告警分级 + 值班管理
  • 可观测性：日志/指标/追踪三位一体

3. Skill 技能库 NEW

  • 23 个 Skill：覆盖架构/开发/数据库/测试/运维/安全/运营/初始化 8 大分类
  • 角色绑定：按权限加载，前端只能用前端 Skill，运维只能用运维 Skill
  • 进化能力：每个 Skill 内置指标跟踪，持续优化
  • Commands：/init-role 加载角色技能，/switch-tool 切换 AI 工具链

4. AI 协同开发

  • 7 个固定角色：架构师/产品经理/前后端/测试/运维/运营
  • 40+ 工作流：每个角色 4-7 个专属工作流
  • 权限治理：IronClaw 实例 + 权限边界 + 审批流程
  • 任务拆分：Handoffs 引擎防止上下文溢出

5. 多环境部署

本地开发

热重载 + 自动迁移

make dev

Docker

一键容器化部署

make docker

Kubernetes

生产级集群部署

make k8s

离线部署

私有化部署包

make offline

🚀 快速开始

1. 克隆脚手架

git clone https://github.com/z58362026/amazing.git && cd amazing

2. 初始化项目

# 标准项目 python3 scripts/init.py my-project # AI 平台项目（包含所有业务 Agent） python3 scripts/init.py my-ai-platform \ --business-agents=compute,data,training,model-service # 数据平台项目 python3 scripts/init.py my-data-platform --business-agents=data

3. 进入项目并启动

cd my-project && make dev

4. 查看规范和角色

# 查看代码规范 cat standards/code/python.md # 查看角色定义 cat .claude/roles/architect/role.md # 查看监控配置 cat .agents/monitoring/agent.md

🛠️ 技术栈

类别 技术
后端 Python 3.11+ / FastAPI / Go / Gin
前端 React 18+ / TypeScript 5+ / Vite / TailwindCSS
数据库 PostgreSQL / MongoDB / Redis
监控 Prometheus / Grafana / ELK / Loki / Jaeger
部署 Docker / Kubernetes / Helm
CI/CD GitHub Actions / GitLab CI
测试 Pytest / Jest / Playwright / JMeter
AI 工具 Claude Code CLI / Codex CLI / Codex Desktop

📝 最新更新

v2.0.0 (2024-03-09) LATEST

  • 新增 Standards 规范体系：9 个规范文件，覆盖代码/Git/API/测试
  • 新增 Monitoring Agent：1 agent + 5 sub-agents，实现全栈可观测性
  • 扩展 Roles 角色体系：7 角色 × 3 文件 = 21 个文件，40+ 工作流
  • 新增 Skill 技能库：23 个 Skill，8 大分类，按角色权限加载
  • 业务 Agent 模板化：4 个业务 Agent 模板，支持按需选择
  • 统一配置语义：roles + subAgents 语义明确
  • 新增文件总数：42 个核心文件