ez-workflow

分类: 工具与效率 | 上传者: rohoswagger | 下载: 0 | 版本: v1.0（最新）

当要在 ez-stack 管理的存储库中运行 git 分支、提交、推送或 PR 操作时使用。提供完整的命令参考和特定于代理的使用模式。

更新日志: Source: GitHub https://github.com/rohoswagger/ez-stack

目录结构

当前层级: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 1014 B
  - 📄 python-wheel.yml 3.3 KB
  - 📄 release.yml 2.2 KB
📁 docs/
- 📁 plans/
  - 📄 2026-03-06-v0.1.3-impl.md 22.7 KB
  - 📄 2026-03-06-v0.1.3-improvements-design.md 2.4 KB
- 📁 superpowers/
  - 📁 plans/
    
    📄 2026-03-10-stack-links.md 15.5 KB
    
    📄 2026-03-11-v0.1.5-agent-ux.md 52.0 KB
    
    📄 2026-03-31-scope-aware-stacking.md 12.5 KB
  - 📁 specs/
    
    📄 2026-03-10-stack-links-design.md 3.7 KB
    
    📄 2026-03-11-v0.1.5-agent-ux.md 6.7 KB
📁 python/
- 📁 ez_stack/
  - 📄 __init__.py 1.0 KB
- 📄 MANIFEST.in 33 B
- 📄 pyproject.toml 1005 B
- 📄 setup.py 232 B
📁 src/
- 📁 cmd/
  - 📄 amend.rs 3.1 KB
  - 📄 branch.rs 159 B
  - 📄 checkout.rs 8.2 KB
  - 📄 commit.rs 4.0 KB
  - 📄 create.rs 10.1 KB
  - 📄 delete.rs 9.2 KB
  - 📄 diff.rs 985 B
  - 📄 draft.rs 1.3 KB
  - 📄 init.rs 2.0 KB
  - 📄 list.rs 10.7 KB
  - 📄 log.rs 8.8 KB
  - 📄 merge.rs 5.2 KB
  - 📄 mod.rs 513 B
  - 📄 move_branch.rs 4.4 KB
  - 📄 mutation_guard.rs 12.3 KB
  - 📄 navigate.rs 4.7 KB
  - 📄 parent.rs 518 B
  - 📄 pr_edit.rs 3.1 KB
  - 📄 pr_link.rs 1.3 KB
  - 📄 pr_view.rs 683 B
  - 📄 push.rs 10.3 KB
  - 📄 rebase_conflict.rs 2.2 KB
  - 📄 restack.rs 5.1 KB
  - 📄 scope.rs 4.7 KB
  - 📄 setup.rs 6.3 KB
  - 📄 shell_init.rs 1.6 KB
  - 📄 skill.rs 8.8 KB
  - 📄 status.rs 10.5 KB
  - 📄 submit.rs 3.3 KB
  - 📄 sync.rs 20.9 KB
  - 📄 update.rs 5.2 KB
  - 📄 worktree.rs 388 B
- 📄 cli.rs 18.1 KB
- 📄 dev.rs 2.0 KB
- 📄 error.rs 2.9 KB
- 📄 git.rs 31.4 KB
- 📄 github.rs 17.7 KB
- 📄 hooks.rs 4.3 KB
- 📄 main.rs 8.2 KB
- 📄 scope.rs 3.0 KB
- 📄 stack.rs 10.4 KB
- 📄 stack_body.rs 5.2 KB
- 📄 test_support.rs 3.6 KB
- 📄 ui.rs 4.6 KB
📄 .gitignore 20 B
📄 AGENTS.md 3.6 KB
📄 Cargo.lock 23.0 KB
📄 Cargo.toml 788 B
📄 CLAUDE.md 14.6 KB
📄 CONTRIBUTING.md 4.4 KB
📄 install.sh 2.3 KB
📄 LICENSE 1.1 KB
📄 README.md 7.8 KB
📄 reference.md 3.2 KB
📄 SKILL.md 5.5 KB

SKILL.md

---
name: ez-workflow
description: Use when about to run git branching, commit, push, or PR operations in a repo managed by ez-stack. Provides the complete command reference and agent-specific usage patterns.
---

# ez-stack

ez-stack makes version control invisible for AI coding agents. Four commands cover the full development lifecycle. Stacked PRs, worktree isolation, and auto-restacking happen automatically.

**When to use ez:** If `.git/ez/stack.json` exists, ALL git operations go through `ez`.

## The 4 Commands

```bash
ez create feat/auth              # 1. Start: worktree + branch + cd
# ... do your work ...
ez push -am "feat: add auth"     # 2. Ship tracked changes
ez push -Am "feat: add auth"     #    or include untracked files too
ez sync --autostash              # 3. Sync: pull trunk, clean merged, restack
ez delete feat/auth --yes        # 4. Done: remove worktree + branch, stop branch dev server, + cd back
```

That's it for normal flows. No raw `git commit`, no raw `git push`, no `gh pr create`, no manual `cd`.
Use `git add -p` only when you need hunk-level selection before `ez commit`.

## Never use these directly

| Instead of | Use |
|------------|-----|
| `git checkout -b` | `ez create` |
| `git commit` | `ez commit`, `ez push -am`, or `ez push -Am` |
| `git push` | `ez push` |
| `gh pr create` | `ez push` |
| `git diff main...HEAD` | `ez diff` |
| `git branch` | `ez list` |

## Agent Startup

```bash
# 1. Check what's happening
ez list

# 2. Create your isolated workspace (always use --from main for independent work)
cd $(ez create my-task --from main)

# 3. You're in .worktrees/my-task with your own branch. Work here.
```

After any `ez create`, `ez switch`, `ez checkout`, `ez delete`, or `ez sync` that may change directories, immediately re-anchor file operations to the active worktree root:

```bash
pwd
git rev-parse --show-toplevel
```

Use that path, not the main repo checkout, for every subsequent read or write. Never reuse an absolute file path captured before switching into a linked worktree.

**Always use `--from main`** for independent tasks. Without it, ez stacks on the current branch.

**Hooks:** If `.ez/hooks/post-create/default.md` exists in the repo, ez prints its instructions after worktree creation. Follow them to set up the worktree (install deps, copy env, etc.). Use `--hook <name>` for a specific hook: `ez create feat/auth --hook setup-node` reads `.ez/hooks/post-create/setup-node.md`.

Hooks are markdown instructions for agents, not executable scripts. ez prints them, you follow them.

## Working

### Commit specific files (keeps changes focused)
```bash
ez commit -m "feat: add types" -- src/types.rs src/mod.rs
```

### Bulk update when the whole tracked diff belongs together
```bash
ez commit -am "chore: regenerate fixtures"
```

### Bulk update including untracked files
```bash
ez commit -Am "feat: add new docs and generated fixtures"
```

### Partial hunks when one file mixes concerns
```bash
git add -p
ez commit -m "fix: keep intended hunks only"
```

### Stack changes (multiple PRs from one workflow)
```bash
ez create feat/auth-api            # stacks on current branch
ez commit -m "feat: add API"
ez create feat/auth-middleware     # stacks on auth-api
ez commit -m "feat: add middleware"
ez submit                          # pushes + creates PRs for entire stack
```

### Self-review before pushing
```bash
ez diff --stat       # what files changed vs parent
ez diff --name-only  # just file names
ez status            # stack info + working tree state
```

### Ship it
```bash
ez push -am "feat: done"               # stage tracked changes + commit + push + create PR
ez push -Am "feat: done"               # include untracked files too
ez push --title "feat: auth" --body "..." # with PR metadata
ez submit                                # push entire stack
```

### Sync with other agents' work
```bash
ez sync --autostash   # pulls trunk, cleans merged PRs, restacks your branches
```

### Finish
```bash
cd $(ez delete my-task --yes)   # removes worktree + branch, stops the branch dev server, cd's to repo root
```

## Multi-Agent Rules

- **One worktree per agent.** Never share a worktree.
- **Always `--from main`** for independent tasks.
- **Sync before push** to pick up other agents' merged work.
- **Preferred commit flow:** `ez commit -m "msg" -- path1 path2`
- **Bulk tracked update:** `ez commit -am "msg"`
- **Bulk tracked + untracked update:** `ez commit -Am "msg"`
- **Partial hunks:** `git add -p` then `ez commit -m "msg"`

## Receipts

Every mutating command emits a JSON receipt to stderr. Parse these to verify operations:

```json
{"cmd":"create","branch":"feat/auth","parent":"main","worktree":".worktrees/feat-auth"}
{"cmd":"push","branch":"feat/auth","pr_number":42,"pr_url":"...","created":true}
{"cmd":"delete","branch":"feat/auth","worktree":".worktrees/feat-auth"}
```

Check `redundant_commits > 0` after sync/restack — means commits were auto-dropped.

## Exit Codes

| Code | Meaning | Action |
|------|---------|--------|
| 0 | Success | Continue |
| 1 | Unexpected error | Log and stop |
| 2 | GitHub API error | `gh auth status` |
| 3 | Rebase conflict | Resolve, `ez restack` |
| 4 | Stale remote ref | `git fetch`, retry |
| 5 | Usage error | `ez status` |
| 6 | Unstaged changes | `--autostash` or `--if-changed` |

## Advanced Commands

See [reference.md](reference.md) for the full command reference: `ez commit`, `ez amend`, `ez diff`, `ez status`, `ez restack`, `ez log`, `ez move`, `ez merge`, `ez switch`, `ez pr-edit`, `ez draft`/`ez ready`, `ez pr-link`, `ez update`, `ez setup`, `ez skill install`.

登录后下载/点赞/收藏 ❤ 9 | ★ 0

ez-workflow

目录结构

SKILL.md

举报内容

提示