| name | ralph-web-architecture |
| description | Ralph 流程专用：在 Web 项目规划阶段，强制生成生产级架构设计（Atomic Components, State, API Spec, DB ERD）。仅当处理 02-architecture.md 时触发。 |
Skill: ralph-web-architecture
📋 技能描述 (Description)
此 Skill 专用于解决“架构设计过于简陋”的问题，确保生成的架构具备生产级深度。
它通过强制执行一系列标准和自检清单，防止生成 "Hello World" 级别的架构设计。
使用场景 (Usage)
- 环境: Ralph Flow
- 项目类型: Web 项目
- 阶段: 规划阶段 (Planning Mode) - 支持 Round 1-3 (Step 3/5)
指令 (Instructions)
Step 3: 竞品调研 (Research)
在 任意 Round 的 Step 3，执行 WebSearch：
- Round 1: 搜索 "架构全景图" (Overall Architecture) 与 "核心模块设计" (Core Module Design)。
- Round 2: 搜索 "数据模型最佳实践" (DB Schema) 与 "API 设计规范" (API Design)。
- Round 3: 搜索 "性能优化" (Performance) 与 "安全合规" (Security)。
Step 5: 一致性锁定 (Lock)
在 任意 Round 的 Step 5，执行 Ripple Check：
- Sync: 确保
01 的变更已同步到 02。
- Verify: 确保 API 定义能覆盖所有前端交互。
- Next Round Trigger:
- Round 1-2: 输出 "🔒 Round X Locked. Proceeding to Round X+1..."
- Round 3: 输出 "✅ Final Architecture Locked."
示例 (Examples)
示例 1：架构调研 (Round 1)
Input:
用户：Research Architecture
Output:
🔍 Searching for "React SaaS Architecture Best Practices"...
Key Findings:
- Use Feature-Sliced Design (FSD) for scalability.
- Separate UI components from business logic (hooks).
Action: Updated
02-architecture.md with recommended directory structure.
示例 2：一致性锁定
Input:
用户：Lock Round 2
Output:
🔒 Locking Round 2
- Requirements vs Architecture: ✅ Consistent
- API Coverage: ✅ 100%
- Status: Ready for Round 3 (Performance & Security).
🛡️ 铁律与约束 (Iron Rules & Constraints)
1. 生产级架构标准 (Production-Ready Standards)
- 框架惯例优先: 严格遵循技术栈最佳实践 (e.g., Next.js App Router, Python Pydantic)。
- 前端架构深度: 必须区分原子组件与业务组件，明确状态管理策略。
- 后端架构深度: 必须定义 API Spec (REST/GraphQL), DB ERD (FK/Index), Auth (JWT/RBAC)。
- 基础设施: 必须包含 CI/CD, 监控, 日志方案。
2. 质量自检清单 (Quality Self-Check)
在生成或审查架构文档时，Agent 必须自问：
- 符合惯例吗？ 是否错误推荐了不兼容的库？
- 分层清晰吗？ 是否混杂了业务逻辑与数据访问？
- 数据规范吗？ 是否遗漏了外键和索引？
- 安全吗？ 敏感接口是否有 Auth 校验？
- 像真的吗？ 能否支撑 10 万用户？
📂 关联资产 (Related Assets)
02-architecture.md (Target)01-requirements.md (Source)
