Update SKILL documentation for phase and bug workflows. Clarified branch creation commands to specify main instead of HEAD, emphasized the importance of not committing phase changes to the bug tree, and provided detailed instructions for managing worktrees and agent interactions. Enhanced clarity on handling dependencies and worktree paths to prevent conflicts.
This commit is contained in:
@@ -49,7 +49,9 @@ N — **одновременные** агенты, не «запусти N и з
|
||||
|
||||
## Старт
|
||||
|
||||
1. Прочитай `docs/phases/README.md` и `docs/phases/reviewed.md`.
|
||||
1. Прочитай `docs/phases/README.md` и `docs/phases/reviewed.md`. Если IDE не
|
||||
на `main` — статусы с `git show main:docs/phases/README.md`, не с рабочей
|
||||
копии (там может быть чужой 🔄 из бага).
|
||||
2. Посчитай, сколько ⬜ с **закрытыми** зависимостями (шапка фазы). 🔄 не бери
|
||||
как новый захват.
|
||||
3. Проверь `git branch --list "phase/*"` и `review/*` — заявка уже стоит.
|
||||
@@ -99,6 +101,7 @@ N — **одновременные** агенты, не «запусти N и з
|
||||
| Пользователь: пауза, только слияние | interrupt разработчикам: коммит WIP **на своей ветке**, не merge, не main. Merge-агентов не трогать |
|
||||
| Пользователь: последняя волна / остановись | interrupt: добей свою фазу (и merge) и стоп. **Новых** агентов не запускать, в том числе по completion |
|
||||
| Пользователь: продолжи | снять паузу с WIP-ветки (`resume` с хешем коммита), не начинать фазу с нуля |
|
||||
| Агент коммитит в `bug/…` / нет worktree | interrupt: стоп в корне IDE, `worktree add` на уже существующую ветку фазы, 🔄 на `main` через `wt-claim-main`. Историю `bug/…` не revert |
|
||||
|
||||
Зависимую ⬜ не открывать, пока зависимость 🔄 или лежит неслитой веткой.
|
||||
|
||||
@@ -107,8 +110,10 @@ N — **одновременные** агенты, не «запусти N и з
|
||||
Транскрипт из 1–2 сообщений («читаю скилл» / `GetMcpTools`) при живом агенте
|
||||
дольше ~15 минут, или тишина после interrupt — **завис**.
|
||||
|
||||
1. `resume` + `interrupt`: брось MCP (`cursor-app-control` не звать), не читай
|
||||
скилл заново, продолжай с ветки/worktree.
|
||||
1. `resume` + `interrupt`: брось MCP (`GetMcpTools` на `cursor-app-control` не
|
||||
звать), не читай скилл заново, продолжай с ветки/worktree. Корень IDE не
|
||||
трогай. Если worktree нет — `git worktree add` на существующую `phase/<N>-*`,
|
||||
не создавай вторую ветку.
|
||||
2. Второй раз — старый: «уступи, git не трогай». Новый агент — **продолжение**
|
||||
того же 🔄: та же ветка и worktree, промпт «замена зависшего». Это не новый
|
||||
захват ⬜ и не второй автор.
|
||||
@@ -145,6 +150,10 @@ N — **одновременные** агенты, не «запусти N и з
|
||||
|
||||
Замена зависшего — существующая ветка в промпте, не пустой `git branch --list`.
|
||||
|
||||
Ветка фазы — `git branch phase/<N>-<slug> main` (не от HEAD). 🔄 только на
|
||||
`main`: если IDE на `bug/…`, одноразовый worktree `wt-claim-main`, не коммит в
|
||||
дерево пользователя. После `worktree add` правки — абсолютным путём worktree.
|
||||
|
||||
Шаблон: [`worker-prompt.md`](worker-prompt.md).
|
||||
|
||||
## Чего не делать
|
||||
@@ -158,6 +167,7 @@ N — **одновременные** агенты, не «запусти N и з
|
||||
- `git push`.
|
||||
- Переставлять чужие 🔄/✅ (замена зависшего 🔄 не трогает: статус тот же).
|
||||
- Снимать чужой `merge/lock` или `checkout` основного дерева с `bug/…` на `main`.
|
||||
- Коммитить 🔄 фазы в дерево `bug/…` или править код фазы в корне IDE.
|
||||
- Заканчивать ответ без списка агентов (ниже).
|
||||
|
||||
## Список агентов
|
||||
|
||||
Reference in New Issue
Block a user