mcpField
D
devstack

devstack

github.com/steveclarke开发3695 次安装今天更新
代码仓库

关于 devstack

Devstack 是使用 process-compose 编排开发环境的技能,提供健康检查、依赖排序和 TUI。它支持人工操作及 AI Agent 的无头工作流,并依据项目的 DEVSTACK.md 配置管理环境。

主要功能

  1. 01使用 process-compose 编排进程
  2. 02检查服务健康状态
  3. 03按依赖关系排序服务
  4. 04通过 TUI 管理环境
  5. 05支持 Agent 无头运行

适用场景

  1. 01初始化项目开发环境
  2. 02启动或停止开发服务
  3. 03查看服务状态和日志
  4. 04开发期间重启服务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/steveclarke/dotfiles --skill devstack

安装后在 Claude Code 中输入/devstack确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
daily-reference.md
init-reference.md
templates/
bin-dev
bin-worktree
DEVSTACK.md
process-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