Install
openclaw skills install complex-app-dev-principlesImanju App Dev Skills
复杂APP模块化开发技能，遵循五大核心原则进行科学、有序、可控的APP开发。适用于从零开始开发复杂APP或重构现有项目。
复杂APP开发原则技能
何时使用此技能
当用户需要以下场景时激活此技能：
- 从头开发I漫剧APP - 从需求分析到最终交付的完整流程
- 重构现有APP项目 - 按模块化原则重新组织代码结构
- 制定APP开发规范 - 建立团队统一的开发流程标准
- 模块化开发咨询 - 获取模块划分、数据共享、测试策略等指导
- 开发流程审计 - 检查现有开发流程是否符合规范
核心开发原则
原则1：建立科学的开发流程
理解和建立APP实现最终功能须经历的步骤，从而建立包含若干必须功能模块的科学先进的开发流程。
实施要点：
- 分析APP最终功能需求
- 拆解功能为独立的必须模块
- 建立模块间的依赖关系和调用顺序
- 制定每个模块的开发标准和验收标准
原则2：模块独立与数据共享
各功能模块独立打包，并按使用逻辑相互联系，各模块生成的数据可在各模块间顺畅共享和理解识别。
实施要点：
- 每个功能模块独立开发、独立测试
- 定义统一的数据接口规范
- 建立模块间数据共享机制
- 确保数据格式在各模块间可被正确识别和处理
原则3：开发者确认与代码锁定
开发过程中设置开发者确认功能，一经开发者确认，须锁定确认前的所有模块功能及相应代码，清除其他无效或与现确认功能不相一致的代码。
实施要点：
- 每个模块完成后必须经过开发者确认
- 确认后的模块代码进入锁定状态
- 自动清除与已确认功能不一致的冗余代码
- 锁定记录可追溯，便于问题回溯
原则4：顺序测试调试
开发流程从前往后对功能模块逐一测试调试，期间不涉及其他模块，一经开发者确认方进入下一模块。
实施要点：
- 按流程顺序依次测试各功能模块
- 当前模块测试期间不引入其他模块干扰
- 开发者确认通过后才能进入下一模块
- 记录每个模块的测试结果和问题
原则5：全局测试与最终锁定
全部模块测试确认后，测试全局，并按开发者意见不断完善修正，最后锁定。
实施要点：
- 所有模块联调，进行全局功能测试
- 根据开发者反馈进行优化修正
- 最终全面验收后锁定全部代码
- 生成开发完成报告和交付物清单
功能模块参考框架（I漫剧APP）
基础模块层（Layer 1）
| 模块名称 | 功能描述 | 优先级 |
|---|---|---|
| 用户认证模块 | 注册、登录、权限管理、OAuth第三方登录 | P0 |
| 内容管理模块 | 漫剧内容的上传、编辑、审核、版本控制 | P0 |
| 用户画像模块 | 用户行为数据收集与分析、偏好建模 | P1 |
业务模块层（Layer 2）
| 模块名称 | 功能描述 | 优先级 |
|---|---|---|
| 播放引擎模块 | 漫剧内容的播放、控制、缓存、画质切换 | P0 |
| 互动社区模块 | 评论、点赞、分享、弹幕、话题讨论 | P1 |
| 推荐算法模块 | 个性化内容推荐、冷启动、热榜 | P1 |
支撑模块层（Layer 3）
| 模块名称 | 功能描述 | 优先级 |
|---|---|---|
| 消息通知模块 | 推送、提醒、站内信、系统通知 | P2 |
| 支付结算模块 | 付费内容、会员订阅、虚拟货币 | P2 |
| 数据分析模块 | 运营数据统计、报表、AB测试 | P2 |
公共模块（Infrastructure）
| 模块名称 | 功能描述 | 优先级 |
|---|---|---|
| 日志记录模块 | 系统运行日志、用户行为日志 | P0 |
| 配置管理模块 | 应用配置、热更新、开关控制 | P1 |
| 异常处理模块 | 全局异常捕获与处理、容灾降级 | P0 |
开发流程
┌─────────────────────────────────────────────────────────────────┐
│ 开发阶段流程 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ [1.需求分析] → [2.模块设计] → [3.模块开发] → [4.模块测试] │
│ ↓ ↓ ↓ ↓ │
│ └────────────────┴──────────────┴──────────────┘ │
│ ↓ │
│ [5.开发者确认] │
│ ↓ │
│ ┌────────────────┬───────────────┬────────────────┐ │
│ ↓ ↓ ↓ ↓ │
│ [6.模块联调] ← [循环至所有模块确认] → [7.联调测试] → [8.全局测试] │
│ ↓ │
│ [9.最终锁定] │
│ │
└─────────────────────────────────────────────────────────────────┘
阶段详细说明
| 阶段 | 输入 | 输出 | 验收标准 |
|---|---|---|---|
| 1.需求分析 | 产品需求文档、用户故事 | 功能清单、优先级排序 | 需求覆盖完整、无遗漏 |
| 2.模块设计 | 功能清单 | 模块划分图、接口定义、数据字典 | 模块边界清晰、依赖关系明确 |
| 3.模块开发 | 模块设计文档 | 可运行代码、单元测试 | 代码符合规范、测试通过 |
| 4.模块测试 | 模块代码 | 测试报告、缺陷列表 | 功能完整、无阻塞缺陷 |
| 5.开发者确认 | 测试报告 | 确认签字、代码锁定 | 开发者审核通过 |
| 6-8.联调测试 | 已锁定模块 | 集成测试报告 | 全流程跑通、性能达标 |
| 9.最终锁定 | 测试报告 | 发布版本、交付清单 | 验收通过、代码冻结 |
代码锁定机制
锁定规则
- 单模块锁定：单个模块开发测试完成后，开发者确认即锁定
- 级联锁定：后续模块依赖已锁定模块时，不得修改已锁定模块
- 解锁流程：如需修改已锁定模块，必须走解锁审批流程
锁定检查清单
- 模块代码已提交到指定分支
- 所有单元测试通过
- 开发者审核签字
- 依赖此模块的其他模块已记录
- 锁定记录已创建
数据共享规范
接口设计原则
┌─────────────┐ 接口契约 ┌─────────────┐
│ 模块A │ ←───────────────→ │ 模块B │
│ │ 统一数据格式 │ │
└─────────────┘ └─────────────┘
数据格式标准
- 使用JSON作为模块间数据交换格式
- 关键字段必须包含：
id、type、timestamp、version - 敏感数据需加密传输
共享数据示例
{
"id": "unique_identifier",
"type": "data_type",
"timestamp": "2026-03-24T03:52:44Z",
"version": "1.0.0",
"payload": {}
}
参考资源
| 资源类型 | 路径 | 说明 |
|---|---|---|
| 模块设计模板 | references/module_design_template.md | 模块设计文档模板 |
| 接口定义规范 | references/api_specification.md | API接口设计规范 |
| 测试用例模板 | references/test_case_template.md | 测试用例编写规范 |
| 交付清单模板 | references/delivery_checklist.md | 项目交付检查清单 |
脚本工具
| 脚本名称 | 用途 | 命令 |
|---|---|---|
validate_structure.py | 验证项目目录结构 | python scripts/validate_structure.py |
generate_module.py | 生成模块骨架代码 | python scripts/generate_module.py <module_name> |
lock_module.sh | 锁定指定模块 | bash scripts/lock_module.sh <module_name> |
版本变更记录
| 版本 | 日期 | 变更内容 |
|---|---|---|
| 1.0.0 | 2026-03-24 | 初始版本，定义五大核心原则和模块框架 |