From 53da2f709499a964ca1c94eda78bf66fc1cfc9b7 Mon Sep 17 00:00:00 2001 From: Steve Beaulac Date: Fri, 25 Sep 2026 13:16:09 -0400 Subject: [PATCH] docs(setup-skills): add Gitea forge write safety rules tea --description does not read stdin via @-, so a piped heredoc silently creates an issue whose body is the literal "@-". Document the command- substitution form, a post-create body check, and inspecting tea --help before relying on CLI syntax. --- skills/setup-skills/issue-tracker-gitea.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/skills/setup-skills/issue-tracker-gitea.md b/skills/setup-skills/issue-tracker-gitea.md index d7ac0c8..d2ede3e 100644 --- a/skills/setup-skills/issue-tracker-gitea.md +++ b/skills/setup-skills/issue-tracker-gitea.md @@ -13,6 +13,15 @@ Issues and PRDs for this repo live as Gitea issues. Use the `tea` CLI for all op Infer the repo from git remote -v — `tea` does this automatically when run inside a clone. +### Forge write safety + + - `tea --description` does not read stdin via `@-`; never use `--description @-`. + - Pass multiline descriptions with shell command substitution: + `tea issue create --description "$(cat <<'EOF' ... EOF)"` + - After every issue create/edit, verify: + `tea issue -o json | jq -e '.body != "" and .body != "@-" and (.body | contains("## Question"))'` + - Inspect `tea --help` before relying on CLI syntax. + ## Pull requests as a triage surface **PRs as a request surface: no.** _(Set to `yes` if this repo treats external PRs as feature requests; `/triage` reads this flag.)_