web-architecture

Web Architecture 是一项针对 TypeScript/Next.js/Convex 技术栈的多代理开发工作流程指南，源于开发者从 29 个并行代理、50K 行代码和 212 个错误中总结的硬核教训。该 Skill 将复杂的全栈项目拆分为六个严格顺序的阶段：Phase 0 引导式初始化（必须顺序执行）、Phase 1 基础文档并行生成、Phase 2 后端实现（建议单代理）、Phase 3 组件库构建（必须单代理）、Phase 4 功能页面并行开发，以及 Phase 5 集成与 QA。其核心方法论强调"单代理全上下文优于多代理部分上下文"，通过锁定 Schema 和类型定义、建立 CONTRACTS.md 契约文件、严格执行功能验证（而非仅通过编译）来避免架构混乱。

该 Skill 的显著优势在于提供了经过实战验证的防崩溃开发范式。它明确区分了"编译通过"与"功能可用"的界限，强制要求验证数据流、UI 渲染、端到端用户流程和错误状态处理，有效避免生成"15K 行零功能代码"的灾难。通过文件锁机制、目录隔离和严格的 Agent 生成顺序，它解决了并行开发中的重复定义、类型冲突和集成噩梦。对于采用 AI 辅助编程的团队，这是一份防止"多代理 chaos"的救命手册。

然而，该 Skill 也存在明显局限性。首先，它高度依赖特定技术栈（TypeScript/Next.js/Convex），对其他框架（如 Vue、Django、Rails）的迁移价值有限。其次，其严格的阶段顺序（特别是 Phase 0 必须在任何其他代理之前完成）可能与追求极致速度的敏捷团队产生摩擦。此外，作为纯文档型 Skill，它仅提供指导原则，无法自动强制执行流程合规性，团队仍需人工监督代理行为。

该 Skill 最适合中大型全栈开发团队，特别是正在采用或计划采用多 AI 代理协作开发复杂 Web 应用的组织。对于从零开始构建 SaaS 产品、需要协调前后端 schema 一致性、或曾因并行代理开发导致代码库混乱的技术负责人而言，这份指南能有效降低架构债务。它也适合作为技术团队的入职培训材料，统一多代理开发规范。

使用风险方面，需注意该 Skill 来自 T3 级社区个人来源（GitHub: openclaw/skills），非官方组织背书，虽内容透明可审计，但缺乏企业级安全合规认证。作为纯文档资产，它本身不执行任何代码，无运行时风险，但团队需自行验证其中推荐的技术栈（如 Clerk 认证、Convex 数据库）是否符合自身安全要求。此外，过度依赖此流程可能降低开发灵活性，小型项目或原型开发可能因流程过重而得不偿失。