步步为营 - 复杂APP开发统一技能

当用户要求进行复杂应用开发、构建 CI/CD 流程、执行 DevOps 任务时，按以下步骤引导。

核心原则

修正原则（最高优先级）

只修正指定问题和相关联代码，不改变其他代码

只修改用户明确指出的问题代码
只修改与问题直接相关的关联代码
已正确运行的功能不得被修改
每次修改前确认变更范围
修改后验证其他功能未被影响

开发理念

每步必测 → 每次代码变更必须运行测试
每层必验 → 每个模块必须通过验证
环环相扣 → 各阶段必须有序衔接
层层守护 → 每层必须有保护机制

开发流程检查清单

1. 需求分析阶段

明确功能需求和非功能需求
拆分任务为可执行的子任务
预估时间和资源
确定验收标准

2. 代码开发阶段

创建功能分支 git checkout -b feature/xxx
编写代码并遵循编码规范
编写单元测试（覆盖率 > 80%）
运行本地 lint/static analysis
进行代码审查

3. 构建阶段

本地构建成功 npm run build / docker build
运行集成测试
安全扫描 npm audit / trivy image
生成构建产物（Docker 镜像/二进制文件）

4. 测试阶段

5. 发布阶段

6. 运维监控阶段

确认监控告警正常
检查日志聚合
验证备份机制
文档更新

常用命令参考

包管理

npm install           # 安装依赖
npm run build        # 构建项目
npm test             # 运行测试
npm run lint         # 代码检查
npm run audit        # 安全审计

Docker

docker build -t app:v1 .              # 构建镜像
docker run -d app:v1                  # 运行容器
docker-compose up -d                  # 启动服务栈
docker logs -f <container>            # 查看日志

Git 工作流

git checkout -b feature/xxx            # 创建功能分支
git add . && git commit -m "feat: xxx"
git push origin feature/xxx           # 推送分支
git merge main                        # 合并主干
git tag v1.0.0 && git push --tags     # 打标签

CI/CD 检查

curl -I http://localhost:PORT/health   # 健康检查
netstat -tlnp | grep PORT             # 端口检查
tail -100 /var/log/app.log            # 查看日志

使用示例

示例1：开发新功能

用户：帮我开发一个用户注册功能
Agent：
1. 创建分支 feature/user-registration
2. 编写 API、数据库模型、单元测试
3. 运行测试确保通过
4. 构建镜像并推送到仓库
5. 执行灰度发布

示例2：排查部署问题

用户：生产环境部署失败了
Agent：
1. 检查构建日志
2. 验证环境变量配置
3. 测试数据库连接
4. 检查网络/端口
5. 执行回滚（如需要）

自动化脚本

检查清单脚本位于 scripts/checklist.sh：

命令	说明
`verify-fix <文件> [哈希]`	验证修正范围（核心安全检查）
`dev-check`	完整开发检查（lint + test + build）
`docker-build [镜像] [标签]`	Docker 构建 + 安全扫描
`health [主机] [端口] [端点]`	HTTP 健康检查
`canary [镜像] [阶段]`	灰度发布（默认: 5,25,100%）
`rollback [命名空间] [部署]`	回滚到上一个稳定版本
`coverage [阈值]`	测试覆盖率检查（默认: 80%）
`all`	执行全部检查

监控模板

从 templates/ 目录导入监控规则：

Grafana (grafana-alerts.json)

应用错误率告警
响应延迟告警
服务可用性告警
CPU/内存/磁盘使用率

Datadog (datadog-alerts.json)

错误率告警
延迟告警
健康检查失败
基础设施指标
日志错误激增检测

验证步骤

每次任务完成后，必须执行：

自检清单 - 对照检查清单确认每项完成
结果报告 - 向用户汇报关键指标（测试覆盖率、构建状态等）
下一步建议 - 提出优化建议或后续行动

bu-bu-wei-ying

Safety Notice

Copy this and send it to your AI assistant to learn