ln-730-devops-setup

路径： 文件路径（references/、../ln-*）相对于此技能目录。

ln-730-devops-setup

类型： L2 领域协调器 类别： 7XX 项目引导 父级： ln-700-project-bootstrap

通过委派给专门的工作器，协调 DevOps 基础设施设置。

---

目的与范围

统筹项目的完整 DevOps 设置：

• 负责： 自动检测技术栈、委派给工作器、验证配置
• 不负责： 直接生成文件（委派给 ln-731、ln-732、ln-733）

---

概览

方面	详情
输入	包含源代码的项目目录
输出	Docker、CI/CD、环境配置
工作器	ln-731（Docker）、ln-732（CI/CD）、ln-733（环境）
模式	自动检测（不向用户提问）

---

支持的技术栈

组件	选项 1	选项 2
前端	React/Vite + Nginx	-
后端	.NET 8/9	Python（FastAPI/Django）
数据库	PostgreSQL	-
CI/CD	GitHub Actions	-

---

工作流

阶段 1：预检验证

检查所需工具和项目结构：

• 确认已安装 Docker（docker --version）
• 确认 docker-compose 可用
• 检查现有 DevOps 文件（覆盖时发出警告）

输出： 验证报告，或停止并提供说明

阶段 2：项目分析（自动检测）

自动检测项目技术栈：

检测项	方法	检查文件
前端	检查是否存在 Package.json	src/frontend/package.json、package.json
.NET 后端	检查是否存在 .csproj/.sln	*.sln、src/**/*.csproj
Python 后端	检查 requirements.txt/pyproject.toml	requirements.txt、pyproject.toml
数据库	检查代码中的连接字符串	appsettings.json、.env.example
现有 CI/CD	检查工作流文件	.github/workflows/、azure-pipelines.yml

版本检测：

• Node.js：从 package.json 的 engines 中读取，或使用 node -v
• .NET：从 *.csproj 的 TargetFramework 中读取
• Python：从 pyproject.toml 或 runtime.txt 中读取
• PostgreSQL：默认为最新稳定版（17）

输出： 包含检测到的版本的技术栈配置对象

阶段 3：工作器委派

并行委派给工作器（独立任务）：

ln-730 (Coordinator)
    |
    +---> ln-731-docker-generator (via Skill tool)
    |         Input: stack config, versions
    |         Output: Dockerfile.*, docker-compose.yml, .dockerignore
    |
    +---> ln-732-cicd-generator (via Skill tool)
    |         Input: stack config, detected commands
    |         Output: .github/workflows/ci.yml
    |
    +---> ln-733-env-configurator (via Skill tool)
              Input: detected environment variables
              Output: .env.example, .env.development, .gitignore updates

错误处理：

• 如果工作器失败，记录错误并继续执行其他工作器
• 最后报告所有失败
• 为失败的组件提供手动修复建议

调用：

Skill(skill: "ln-731-docker-generator", args: "{projectPath}")
Skill(skill: "ln-732-cicd-generator", args: "{projectPath}")
Skill(skill: "ln-733-env-configurator", args: "{projectPath}")

阶段 4：配置验证

验证生成的配置：

• 运行 docker-compose config 验证语法
• 检查所有引用的文件是否存在
• 确认已提交的文件中没有密钥

输出： 验证报告

阶段 5：完成报告

生成摘要：

• 列出所有创建的文件
• 显示检测到的技术栈配置
• 为用户提供后续步骤

---

生成的文件

Docker（ln-731）

• Dockerfile.frontend - 前端多阶段构建
• Dockerfile.backend - 后端多阶段构建
• docker-compose.yml - 服务编排
• docker-compose.override.yml - 开发环境覆盖配置（可选）
• .dockerignore - 构建上下文排除项

CI/CD（ln-732）

• .github/workflows/ci.yml - 主 CI 流水线

环境（ln-733）

• .env.example - 包含所有变量的模板
• .env.development - 开发环境默认值
• .env.production - 生产环境模板（占位符）
• .gitignore 更新 - 密钥保护

---

关键说明

1. 仅自动检测： 不进行交互式提问。使用检测到的值或合理的默认值。
2. 幂等： 创建前检查文件是否存在。覆盖前发出警告。
3. 并行执行： 工作器相互独立，可以并行运行。
4. 错误恢复： 部分失败时继续执行，并在最后报告所有问题。
5. 固定版本： 使用检测到的版本，而不是硬编码的值。

---

TodoWrite 格式（必需）：

- Invoke ln-731-docker-generator (pending)
- Invoke ln-732-cicd-generator (pending)
- Invoke ln-733-env-configurator (pending)
- Verify configuration (pending)
- Generate completion report (pending)

Worker 调用（必须）

Host Skill 调用： 必须委派执行 Skill(skill: "...", args: "...")。

• Claude：严格按照所示方式调用 Skill 工具。
• Codex：如果没有 Skill 工具，则在可用技能中找到指定技能，读取其 SKILL.md，将 args 视为 $ARGUMENTS，执行该技能的工作流，然后返回此处并提供其结果或产物。
• 不要内联执行 Worker 逻辑，也不要在未执行目标技能的情况下将 Worker 标记为已完成。

阶段	Worker	上下文
3a	ln-731-docker-generator	共享（Skill 工具）— Dockerfiles、docker-compose、.dockerignore
3b	ln-732-cicd-generator	共享（Skill 工具）— CI/CD 流水线配置
3c	ln-733-env-configurator	共享（Skill 工具）— 环境文件和 .gitignore

所有 Worker： 通过 Skill 工具调用 — Worker 可查看协调器上下文。

完成定义

• 预检验证已通过
• 已成功自动检测技术栈
• 所有 Worker 均已完成（或已记录失败情况）
• docker-compose config 验证通过
• 生成的文件中不含机密信息
• 已显示完成报告

---

参考文件

• Worker：../ln-731-docker-generator/SKILL.md
• Worker：../ln-732-cicd-generator/SKILL.md
• Worker：../ln-733-env-configurator/SKILL.md

---

元分析

可选参考：仅当用户要求运行后元分析或采用协议格式的运行反思时，才加载 references/meta_analysis_protocol.md。

技能类型：execution-orchestrator。如有请求，请在所有阶段完成后运行。使用 execution-orchestrator 格式在聊天中输出。

---

版本： 1.1.0 最后更新： 2026-01-10