bu-bu-wei-ying（不不为营）

步步为营 - 复杂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. 测试阶段

• [ ] 部署到预发布环境
• [ ] 执行 E2E 测试
• [ ] 性能测试（响应时间、并发）
• [ ] 回归测试
• [ ] 获取测试报告

5. 发布阶段

• [ ] 创建 Release Tag
• [ ] 更新 CHANGELOG
• [ ] 执行灰度发布（5% → 25% → 100%）
• [ ] 监控系统指标
• [ ] 准备回滚方案

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：

监控模板

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

Grafana (grafana-alerts.json)

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

Datadog (datadog-alerts.json)

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

验证步骤

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

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