Document the local-repo requirement of pulls create #37

Closed
opened 2026-08-10 12:45:26 +00:00 by claude · 1 comment
Collaborator

Summary

skills/use/SKILL.md:56-57 обещает, что вне git-репозитория достаточно
передать --repo owner/repo. Для pulls create это неправда: команда падает,
и открыть PR по инструкции из скилла нельзя.

Spec

skills/use/references/tea/entities.md

Steps to reproduce

  1. Перейти в каталог, который не является git-репозиторием (cd /tmp).
  2. Выполнить команду ровно так, как советует skills/use/SKILL.md:53-57:
    tea pulls create --login "$GITEA_LOGIN" --repo claude-skills/tea \
      --head feat/x --base main --title t --description d
    

Expected

PR создаётся: --repo owner/repo заявлен в skills/use/SKILL.md:56-57 как
замена автодетекту и в skills/use/references/tea/index.md:17 как «override
repository context (local path or slug)».

Actual

Error: local repository required: execute from a repo dir, or specify a path with --repo

Слаг owner/repo не принимается — нужен либо CWD внутри чекаута, либо путь.
tea pulls list --repo claude-skills/tea из того же каталога отрабатывает
нормально, то есть ограничение относится именно к create, а не к --repo
вообще. Описание подкоманды в skills/use/references/tea/entities.md:24 про
это не говорит ни слова.

Цена ошибки не нулевая: агент, который делает PR из git worktree или из
каталога вне репозитория, получает отказ на последнем шаге задачи и вынужден
угадывать причину.

Environment

tea 0.14.2, Gitea 1.26.1, macOS. Воспроизведено при открытии PR #36.

Acceptance criteria

  • skills/use/references/tea/entities.md в описании pulls create говорит,
    что нужен локальный чекаут: слаг owner/repo не принимается, --repo
    здесь — путь к каталогу репозитория
  • skills/use/SKILL.md рядом с советом «otherwise pass --repo owner/repo»
    называет pulls create исключением
  • в документации есть рабочая формулировка для случая worktree: запускать
    команду с CWD внутри основного чекаута
<!-- tea:id document-the-local-repo-requirement-of-pulls --> ## Summary `skills/use/SKILL.md:56-57` обещает, что вне git-репозитория достаточно передать `--repo owner/repo`. Для `pulls create` это неправда: команда падает, и открыть PR по инструкции из скилла нельзя. ## Spec skills/use/references/tea/entities.md ## Steps to reproduce 1. Перейти в каталог, который не является git-репозиторием (`cd /tmp`). 2. Выполнить команду ровно так, как советует `skills/use/SKILL.md:53-57`: ``` tea pulls create --login "$GITEA_LOGIN" --repo claude-skills/tea \ --head feat/x --base main --title t --description d ``` ## Expected PR создаётся: `--repo owner/repo` заявлен в `skills/use/SKILL.md:56-57` как замена автодетекту и в `skills/use/references/tea/index.md:17` как «override repository context (local path or slug)». ## Actual ``` Error: local repository required: execute from a repo dir, or specify a path with --repo ``` Слаг `owner/repo` не принимается — нужен либо CWD внутри чекаута, либо путь. `tea pulls list --repo claude-skills/tea` из того же каталога отрабатывает нормально, то есть ограничение относится именно к `create`, а не к `--repo` вообще. Описание подкоманды в `skills/use/references/tea/entities.md:24` про это не говорит ни слова. Цена ошибки не нулевая: агент, который делает PR из git worktree или из каталога вне репозитория, получает отказ на последнем шаге задачи и вынужден угадывать причину. ## Environment tea 0.14.2, Gitea 1.26.1, macOS. Воспроизведено при открытии PR #36. ## Acceptance criteria - [ ] `skills/use/references/tea/entities.md` в описании `pulls create` говорит, что нужен локальный чекаут: слаг `owner/repo` не принимается, `--repo` здесь — путь к каталогу репозитория - [ ] `skills/use/SKILL.md` рядом с советом «otherwise pass `--repo owner/repo`» называет `pulls create` исключением - [ ] в документации есть рабочая формулировка для случая worktree: запускать команду с CWD внутри основного чекаута
claude added this to the Self-improvement milestone 2026-08-10 12:45:26 +00:00
claude added the
type
bug
severity
low
comp/docscomp/use
labels 2026-08-10 12:45:26 +00:00
Author
Collaborator

Дубликат #28 — закрываю в его пользу.

Оба воспроизведения теперь в одной issue: из git worktree и из каталога, который
вообще не репозиторий. Отказ один и тот же, а два разных входа делают понятной
границу проблемы.

Уникальные вклады этой issue перенесены в #28 целиком:

  • воспроизведение из /tmp — каталога вне репозитория, командой ровно из
    skills/use/SKILL.md:53-57;
  • ключевое наблюдение, что pulls list --repo claude-skills/tea из того же
    каталога отрабатывает нормально: ограничение у create, а не у --repo;
  • цена ошибки — отказ приходит на последнем шаге задачи, когда ветка уже
    запушена;
  • критерии на entities.md, на исключение рядом с советом в SKILL.md и на
    формулировку для worktree.

Сцепление с #24 отмечено в теле: в worktree ломается и транспорт, и открытие
PR, по разным причинам.

Дубликат #28 — закрываю в его пользу. Оба воспроизведения теперь в одной issue: из git worktree и из каталога, который вообще не репозиторий. Отказ один и тот же, а два разных входа делают понятной границу проблемы. Уникальные вклады этой issue перенесены в #28 целиком: - воспроизведение из `/tmp` — каталога вне репозитория, командой ровно из `skills/use/SKILL.md:53-57`; - ключевое наблюдение, что `pulls list --repo claude-skills/tea` из того же каталога отрабатывает нормально: ограничение у `create`, а не у `--repo`; - цена ошибки — отказ приходит на последнем шаге задачи, когда ветка уже запушена; - критерии на `entities.md`, на исключение рядом с советом в `SKILL.md` и на формулировку для worktree. Сцепление с #24 отмечено в теле: в worktree ломается и транспорт, и открытие PR, по разным причинам.
Sign in to join this conversation.