devstack

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Devstack — Dev Environment Orchestration

Devstack — 开发环境编排

Manages dev environments using process-compose for headless process orchestration with health checks, dependency ordering, and a TUI. Works for both humans and AI agents.

Status: Work in progress (March 2026). If you encounter unexpected issues controlling the running stack (client commands failing, connection refused, socket errors), surface these to the user immediately rather than silently working around them. The user maintains this skill and needs feedback to improve it.

使用process-compose管理开发环境，支持无头进程编排、健康检查、依赖排序以及TUI界面。同时适用于人工操作和AI Agent。

状态： 开发中（2026年3月）。如果在控制运行中的栈时遇到意外问题（如客户端命令执行失败、连接被拒绝、套接字错误），请立即告知用户，而非自行静默处理。该技能由用户维护，需要反馈来进行改进。

Determine Mode

确定模式

Check context to determine which mode to use:

Init mode — the project does NOT have a

DEVSTACK.md

yet, or the user explicitly asks to set up devstack:

Read the init reference:
```
references/init-reference.md
```

Daily mode — the project HAS a

DEVSTACK.md

, and the user wants to create worktrees, start/stop services, or manage the dev environment:

Read
```
DEVSTACK.md
```
in the project root and follow its instructions
For troubleshooting or advanced patterns, read:
```
references/daily-reference.md
```

根据上下文确定要使用的模式：

初始化模式 — 项目尚未创建

DEVSTACK.md

，或用户明确要求搭建devstack：

阅读初始化参考文档：
```
references/init-reference.md
```

日常模式 — 项目已存在

DEVSTACK.md

，且用户需要创建工作树、启动/停止服务或管理开发环境：

阅读项目根目录下的
```
DEVSTACK.md
```
并遵循其指示
如需故障排查或了解高级用法，请阅读：
```
references/daily-reference.md
```

Quick Reference (Daily Mode)

快速参考（日常模式）

DEVSTACK.md

exists, these are the standard commands:

Task	Command
Start (human, TUI)	`bin/dev`
Start (agent, headless)	`bin/dev -D`
Stop	`bin/dev stop`
Status (table)	`bin/dev status`
Status (JSON)	`bin/dev status --json`
Logs	`bin/dev logs <service>`
Restart service	`bin/dev restart <service>`
Wait for healthy	`bin/dev status` (poll until all services show Ready)

Always read

DEVSTACK.md

for project-specific details — the commands above are conventions, not guarantees.

如果项目中存在

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

了解项目特定细节 — 上述命令仅为通用约定，不保证适用于所有项目。