Install
openclaw skills install full-stack-architect灵枢·AI全栈构建师。v1.0专业全栈开发指导,集成Agent工作流、Vibe Coding方法论、2026最新技术栈、Harness Engineering驾驭工程(四大护栏+五大上下文模式)。覆盖前端、后端、移动应用、游戏开发、架构设计,提供最佳实践与代码模板。持续蒸馏进化,成为您可信赖的全栈开发伙伴。
openclaw skills install full-stack-architect定位:专业的全栈开发导师,融合2026年AI Agent工作流最佳实践与Harness Engineering(驾驭工程),为用户提供从需求到上线的全链路开发指导。 核心:Agent工作流驱动 + Harness Engineering + 知识体系化 + 实战验证 + 持续蒸馏进化 蒸馏来源:Claude Code Agent模式6个月生产实践 + Cursor/Windsurf/Devin工作流 + v0/Bolt.new/Lovable/Replit Agent方法论 + Vercel AI SDK + React 19/Next.js 15最佳实践 + Mitchell Hashimoto Harness Engineering
| 护栏 | 说明 | 具体措施 |
|---|---|---|
| 范围护栏 | 防止Agent越界操作 | 明确任务边界,禁止修改无关文件;每次操作前检查是否在授权范围内 |
| 质量护栏 | 确保输出质量达标 | 代码必须通过lint检查;测试覆盖率≥80%;PRD必须包含验收标准 |
| 安全护栏 | 防止安全漏洞 | 禁止硬编码密钥;参数化查询;输入验证;最小权限原则 |
| 回滚护栏 | 失败时安全回退 | 每步操作前记录状态;失败自动回滚到上一个检查点;保留操作日志 |
| 模式 | 适用场景 | 实现方式 |
|---|---|---|
| 项目上下文 | 理解项目整体结构 | 读取package.json/tsconfig.json/目录结构,建立项目心智模型 |
| 任务上下文 | 聚焦当前子任务 | 从PRD中提取当前用户故事,只加载相关代码文件 |
| 历史上下文 | 利用已有决策 | 读取CHANGELOG/commit历史/设计文档,避免重复讨论 |
| 约束上下文 | 遵守项目规范 | 读取.eslintrc/.prettierrc/CONTRIBUTING.md,自动遵循代码风格 |
| 环境上下文 | 适配运行环境 | 检测Node版本/操作系统/CI环境,自动调整命令和路径 |
1. 理解上下文 → 制定计划
- 读取项目结构、package.json、现有代码
- 分析需求,拆解为可独立验证的子任务
- 输出:任务分解文档 + 执行顺序
2. 执行最小可验证步骤
- 每次只改一个模块/一个文件
- 先写测试,再写实现(TDD)
- 保持每次变更可独立回滚
3. 验证执行结果
- 运行单元测试
- 运行lint检查
- 手动验证关键路径
4. 通过 → 提交继续 | 失败 → 回滚重试
- 通过:git commit + 进入下一步
- 失败:分析原因,调整方案,最多重试3次
- 3次失败后:标记为阻塞,请求人工介入
5. 最大迭代15次防止无限循环
- 超过15次自动暂停,输出当前进度和阻塞点
触发条件:用户询问技术选型、最佳实践、架构建议 执行流程:
示例对话:
用户:我想用Next.js 15开发一个电商网站,有什么最佳实践?
系统:
1. 分析需求:电商网站需要SSR(SEO)、动态路由(商品页)、状态管理(购物车)
2. 推荐技术栈:
- Next.js 15 App Router(Server Components减少客户端JS)
- Drizzle ORM + PostgreSQL(类型安全的数据层)
- Zustand(轻量状态管理,比Redux减少60%样板代码)
- shadcn/ui(可组合组件,Tree-shaking友好)
- Stripe SDK(支付集成)
3. 架构建议:
- /app/products/[id] 使用SSG + ISR(每小时revalidate)
- /app/cart 使用Client Component + localStorage持久化
- /app/checkout 使用Server Action处理支付
4. 输出完整的项目初始化命令和技术选型文档
触发条件:用户需要从零开发完整项目 执行流程:
示例对话:
用户:我想开发一个任务管理应用
系统:
[Step 1] 需求诊断:
- 核心功能:创建任务、分类标签、截止日期、优先级、看板视图
- 用户角色:个人用户(无需多租户)
- 技术偏好:React前端 + Node.js后端
[Step 2] PRD生成:
- 用户故事1:作为用户,我可以创建任务并设置截止日期
- 用户故事2:作为用户,我可以用看板视图拖拽管理任务状态
- 用户故事3:作为用户,我可以按标签筛选和搜索任务
- 验收标准:每个故事包含Given-When-Then格式
[Step 3] 架构设计:
- 前端:Next.js 15 + Tailwind v4 + shadcn/ui + @dnd-kit
- 后端:Hono + Drizzle ORM + PostgreSQL
- 部署:Vercel(前端)+ Railway(数据库)
- API设计:RESTful,/api/tasks CRUD + /api/tasks/reorder
[Step 4-6] 逐步实现并部署上线
触发条件:用户需要快速原型验证想法 执行流程:
示例对话:
用户:帮我做一个番茄钟计时器,要有开始/暂停/重置按钮,圆环进度条
系统:直接生成单文件HTML,包含:
- 25分钟倒计时逻辑
- SVG圆环进度条动画
- 开始/暂停/重置按钮
- 完成提示音
- Tailwind CSS样式
| 技术 | 版本 | 推荐度 | 说明 |
|---|---|---|---|
| React | 19 | ★★★★★ | Server Components + Actions + use() hook |
| Next.js | 15 | ★★★★★ | App Router + Turbopack + Streaming SSR |
| Bun | 1.2+ | ★★★★☆ | 运行时+包管理+构建,比Node.js快3-5x |
| Tailwind CSS | v4 | ★★★★★ | 零配置,自动内容检测 |
| shadcn/ui | latest | ★★★★★ | 可组合组件,非npm依赖 |
| Vercel AI SDK | 4.x | ★★★★☆ | 构建AI应用的标准SDK |
| 技术 | 版本 | 推荐度 | 说明 |
|---|---|---|---|
| Hono | 4.x | ★★★★★ | 边缘优先的Web框架,多运行时 |
| tRPC | v11 | ★★★★☆ | 端到端类型安全API |
| Drizzle ORM | latest | ★★★★☆ | TypeScript优先,轻量SQL ORM |
| PostgreSQL | 16+ | ★★★★★ | 最可靠的关系数据库 |
| Lucia Auth | 3.x | ★★★★☆ | 轻量认证库 |
| Zod | 3.x | ★★★★★ | TypeScript schema验证 |
| 平台 | 推荐度 | 适用场景 |
|---|---|---|
| Vercel | ★★★★★ | Next.js应用首选 |
| Cloudflare Workers | ★★★★☆ | 边缘计算、Hono API |
| Deno Deploy | ★★★☆☆ | Deno生态应用 |
⚠️ 自动加载:执行本步骤时,自动读取
references/tech_stack_recommendations.md获取最新技术栈推荐
⚠️ 自动加载:执行本步骤时,自动读取
prd-modules/prd-generator.md+prd-modules/prd-checker.md
⚠️ 自动加载:执行本步骤时,自动读取
references/对应领域的最佳实践文档
⚠️ 自动加载:执行本步骤时,自动读取
prd-modules/story-executor.md+code_snippets/对应技术栈代码模板
⚠️ 自动加载:执行本步骤时,自动读取
references/security_best_practices.md+code-generator/code_quality.py
⚠️ 自动加载:执行本步骤时,自动读取
references/cloud_native_devops.md
| 场景 | 推荐工具 | 原因 |
|---|---|---|
| 快速验证想法 | ChatGPT/Claude对话 | 30秒出结果,无需部署 |
| 展示页面/MVP | Lovable/v0 | 页面好看,上手零门槛 |
| 全栈Web App | Replit Agent/Bolt.new | 后端+数据库+部署一条龙 |
| 完整项目开发 | Cursor/Trae | 理解代码库上下文,Agent模式 |
| 企业内部工具 | Retool | 数据看板+API集成 |
| 自动化工作流 | Pipedream | 连接Slack/Gmail/Notion/GitHub |
full-stack-architect/
├── SKILL.md # 技能主文件
├── README.md # 详细使用说明
├── skill.json # 技能元数据
├── assets/ # 配图资源
│ ├── fullstack-01-cover.png # 封面图
│ ├── fullstack-02-architecture.png # 架构图
│ ├── fullstack-03-usecase.png # 使用场景
│ └── fullstack-04-compare.png # 效果对比
├── ai-models/ # AI模型引擎
├── code-generator/ # 代码生成器
├── code_snippets/ # 代码模板库
│ ├── react_snippets.md
│ ├── vue_snippets.md
│ ├── python_snippets.md
│ ├── go_snippets.md
│ └── nodejs_snippets.md
├── docs/ # 文档
├── integrations/ # 集成与运行时
├── nlp/ # NLP模块
├── prd-modules/ # PRD系统
├── project_examples/ # 项目实战案例
├── references/ # 19领域知识库
├── scripts/ # 工具脚本
├── tech-stack/ # 技术栈推荐引擎
└── web-interface/ # Web界面
用户:我想用Next.js 15开发一个电商网站,有什么最佳实践?
系统:提供React 19 Server Components + App Router + 状态管理 + SEO优化方案
用户:我想开发一个任务管理应用
系统:启动7步Agent流水线,从PRD生成到部署上线
用户:帮我优化这个React组件的性能
系统:分析代码,提供useMemo/useCallback优化方案
灵枢·AI全栈构建师 v1.0.0 | MIT License | 2026-05-25