complex-app-dev-principles

复杂APP模块化开发技能,遵循五大核心原则进行科学、有序、可控的APP开发。适用于从零开始开发复杂APP或重构现有项目。

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "complex-app-dev-principles" with this command: npx skills add smxtx/complex-app-dev-principles

复杂APP开发原则技能

何时使用此技能

当用户需要以下场景时激活此技能:

  1. 从头开发I漫剧APP - 从需求分析到最终交付的完整流程
  2. 重构现有APP项目 - 按模块化原则重新组织代码结构
  3. 制定APP开发规范 - 建立团队统一的开发流程标准
  4. 模块化开发咨询 - 获取模块划分、数据共享、测试策略等指导
  5. 开发流程审计 - 检查现有开发流程是否符合规范

核心开发原则

原则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.最终锁定测试报告发布版本、交付清单验收通过、代码冻结

代码锁定机制

锁定规则

  1. 单模块锁定:单个模块开发测试完成后,开发者确认即锁定
  2. 级联锁定:后续模块依赖已锁定模块时,不得修改已锁定模块
  3. 解锁流程:如需修改已锁定模块,必须走解锁审批流程

锁定检查清单

  • 模块代码已提交到指定分支
  • 所有单元测试通过
  • 开发者审核签字
  • 依赖此模块的其他模块已记录
  • 锁定记录已创建

数据共享规范

接口设计原则

┌─────────────┐      接口契约      ┌─────────────┐
│   模块A     │ ←───────────────→ │   模块B     │
│             │   统一数据格式     │             │
└─────────────┘                   └─────────────┘

数据格式标准

  • 使用JSON作为模块间数据交换格式
  • 关键字段必须包含:idtypetimestampversion
  • 敏感数据需加密传输

共享数据示例

{
  "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.mdAPI接口设计规范
测试用例模板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.02026-03-24初始版本,定义五大核心原则和模块框架

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

Gigo Lobster Taster

🦞 GIGO · gigo-lobster-taster: 正式试吃模式:跑完整评测,默认上传云端、生成个人结果页并进入排行榜。 Triggers: 试吃我的龙虾 / 品鉴我的龙虾 / lobster taste / lobster taster.

Registry SourceRecently Updated
General

Invoice Generator

Creates professional invoices in markdown and HTML

Registry SourceRecently Updated
92001kalin
General

backstage companion

Anti-drift protocol script. Ensures parity between docs and system. Triggers: 'bom dia PROJECT' / 'good morning PROJECT' (load project context with health ch...

Registry SourceRecently Updated
General

stratos-storage

Upload and download files to/from Stratos Decentralized Storage (SDS) network. Use when the user wants to store files on Stratos, retrieve files from Stratos, upload to decentralized storage, or download from SDS.

Registry SourceRecently Updated