关于 devstack
Devstack 是使用 process-compose 编排开发环境的技能,提供健康检查、依赖排序和 TUI。它支持人工操作及 AI Agent 的无头工作流,并依据项目的 DEVSTACK.md 配置管理环境。
主要功能
- 01使用 process-compose 编排进程
- 02检查服务健康状态
- 03按依赖关系排序服务
- 04通过 TUI 管理环境
- 05支持 Agent 无头运行
适用场景
- 01初始化项目开发环境
- 02启动或停止开发服务
- 03查看服务状态和日志
- 04开发期间重启服务
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ steveclarke/ dotfiles --skill devstack安装后在 Claude Code 中输入/devstack确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/daily-reference.mdinit-reference.mdtemplates/bin-devbin-worktreeDEVSTACK.mdprocess-compose.yml详细介绍
Devstack — 开发环境编排
使用 process-compose 管理开发环境,支持无头进程编排、健康检查、依赖排序和 TUI。适用于人类和 AI Agent。
状态: 正在开发中。如果你在控制正在运行的堆栈时遇到意外问题(客户端命令失败、连接被拒绝、 套接字错误),请立即告知用户,而不要默默绕过问题。用户维护此技能,需要获得反馈以 改进它。
确定模式
检查上下文以确定要使用的模式:
初始化模式 — 项目尚无 DEVSTACK.md,或用户明确要求设置 devstack:
- 阅读初始化参考文档:
references/init-reference.md
日常模式 — 项目已有 DEVSTACK.md,且用户希望创建工作树、启动/停止服务或管理开发环境:
- 阅读项目根目录中的
DEVSTACK.md,并遵循其中的说明 - 如需排查问题或了解高级用法,请阅读:
references/daily-reference.md
快速参考(日常模式)
如果 DEVSTACK.md 存在,以下是标准命令:
| 任务 | 命令 |
|---|---|
| 启动(人类,TUI) | bin/dev |
| 启动(Agent,无头模式) | bin/dev -D |
| 停止 | bin/dev stop |
| 状态(表格) | bin/dev status |
| 状态(JSON) | bin/dev status --json |
| 日志 | bin/dev logs <service> |
| 重启服务 | bin/dev restart <service> |
| 等待服务就绪 | bin/dev status(轮询,直到所有服务均显示 Ready) |
始终阅读 DEVSTACK.md,了解项目特定的详情——以上命令是惯例,并非保证适用。
评论
支持 Markdown