閘教的那條出路要真的走得通（inkstone/ISEP#112）
comment-carries-task-guard 擋下留言時教人跑 `scripts/ticket subtask …`，
而那一行跑不動。兩個獨立的原因，各自都足以害死它：
① 相對路徑對「貼上去那個人的 cwd」解析。總管的 cwd 是 InkStoneCo/，
那裡的 scripts/ticket 是停在 08-27 之前的舊複本（grep -c subtask → 0），
照著貼只印出它「四個動詞」的說明然後 exit 0。
② 用法是手抄的第二份，而它已經漂了：寫了 --assign 卻沒有 --next，
正本會因為「指派了人卻沒寫 --next」直接擋下（exit 2，在打 API 之前）。
修法是拿掉可以漂的那一格，不是把兩份對齊一次：
- 路徑 scripts/ticket 的 self_path()（__file__ 的絕對路徑）
⇒ 印指令的人與跑指令的人是同一個檔案
- 用法 USAGE / usage_text() 一份，閘去 `ticket usage subtask --example` 現要
- 內文模板 body_template() 由 REQUIRED_SECTIONS 現生，跟檢查同源
新增動詞 `ticket usage <verb> [--example] [--parent] [--draft]`。
閘的訊息改成整塊可貼可跑：腳本絕對路徑、母票已填、內文草稿附在同一塊裡，
只剩標題／目標／驗收條件三格是機器不可能知道的。
正本叫不動時 fail-open 的只有「訊息內容」（只指路，不補一份手抄用法），
擋不擋不受影響。
測試 scripts/test-comment-carries-task-guard.sh 22 → 29 條。
新增的 ⑮–㉑ 驗的是「出路走不走得通」，不是「有沒有擋」——
⑱ 把閘 stderr 裡那塊指令原樣抽出來、只填三格、真的執行一次，
離開碼必須是 1（走到網路才停）；是 2 就代表這個病復發。
六個變異全部驗過會紅（相對路徑／閘自己抄用法／--assign 沒配 --next／
模板寫死少一段／fallback 補回手抄用法）。
版本：待總管定版（plugin update 比的是版本號不是內容）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SP7DiGMfSkWjZ15CHMbPFE
This commit is contained in:
+144
-9
@@ -26,6 +26,8 @@ leo 2026-08-16 三句話，本工具就是它們的機械化：
|
||||
ticket mine [--user <誰>] 撈一次：棒子在誰手上、每根下一步是什麼
|
||||
ticket loose 撈一次：下游都關了、自己還開著的頂層票
|
||||
|
||||
ticket usage <動詞> [--example] 用法的唯一真相源——**閘印的那一行從這裡來**
|
||||
|
||||
票的寫法：`owner/repo#N`，例：`inkstone/InkStoneCo#44`
|
||||
"""
|
||||
import json
|
||||
@@ -504,6 +506,10 @@ def _writeback(owner, repo, num, deliv):
|
||||
for i in open_left]
|
||||
lines += ["", "⇒ 本票維持原狀，不要當成可以收了。"]
|
||||
else:
|
||||
# 🔴 這一段是要**貼進 Gitea 留言**的，所以 `ticket close` 刻意寫成相對的
|
||||
# ——留言會被別台機器讀到，寫死本機的絕對路徑等於寫死一個他們沒有的檔案。
|
||||
# 絕對路徑那條規約（inkstone/ISEP#112）管的是**印到終端機、要人複製貼上**的字，
|
||||
# 兩者分界就是這一句：「這行字會被誰複製、在哪台機器上跑？」
|
||||
lines += ["", "**這是最後一張下游——本票的下游已經全部關閉。**", "",
|
||||
f"{BATON_MARK} → `{HANDBACK_TO}`", "",
|
||||
"**下一步**：驗一次頂層要的東西真的到齊了，到齊就 "
|
||||
@@ -719,6 +725,134 @@ def writeback_plan(parent_state, parent_deps):
|
||||
return ("note" if open_left else "handback"), open_left
|
||||
|
||||
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
# inkstone/ISEP#112 — 閘教的那行指令要真的跑得動
|
||||
#
|
||||
# 票上的原話：「**當它教的做法不存在，它就從『幫你』變成『擋你』**——
|
||||
# 而且被擋的人當下正在做別的事，最可能的反應是找個理由繞過去。」
|
||||
#
|
||||
# 那次它為什麼跑不動，兩個獨立的原因（2026-08-31 實測，兩個都會單獨害死它）：
|
||||
#
|
||||
# ① **相對路徑**。閘印的是 `scripts/ticket subtask …`，而相對路徑是對
|
||||
# **貼上去那個人的 cwd** 解析的。總管的 cwd 是 `InkStoneCo/`，那裡的
|
||||
# `scripts/ticket` 是本檔停在 2026-08-27 之前的**舊複本**：
|
||||
# grep -c subtask InkStoneCo/scripts/ticket → 0
|
||||
# 它的 docstring 只列到「四個動詞」，於是照著貼會印出那段說明、exit 0、
|
||||
# 什麼都沒發生 —— 正是票上寫的症狀。
|
||||
# （`hooks/lib/beacon_report.py` ② 已經會在 SessionStart 報這個舊複本，
|
||||
# 但**報告不會改掉閘印出來的那一行**。）
|
||||
#
|
||||
# ② **用法各寫一份**。閘手寫了一段用法，`cmd_subtask` 的 die() 又寫了一段。
|
||||
# 兩份已經漂了：閘那份寫 `--assign <誰做>` 卻**沒有 `--next`**，
|
||||
# 而 cmd_subtask 會因為「🚫 指派了人卻沒寫 --next。」直接 die（實測 exit 2，
|
||||
# 而且是在打任何 API 之前，所以離線也複現得出來）。
|
||||
# ⇒ 就算路徑對了，那一行照樣跑不完。
|
||||
#
|
||||
# 🔴 修法是**拿掉可以漂的那一格**，不是把兩份對齊一次：
|
||||
# · 路徑 → self_path()，`__file__` 的絕對路徑。印指令的人與跑指令的人
|
||||
# 是同一個檔案，沒有第二種可能。
|
||||
# · 用法 → USAGE 這一份。閘去 `ticket usage subtask` 拿，不自己抄。
|
||||
# · 內文模板 → body_template() 由 REQUIRED_SECTIONS 現生。
|
||||
# 檢查與模板同一個來源 ⇒ 模板不可能少一段。
|
||||
# ══════════════════════════════════════════════════════════════════════════
|
||||
|
||||
def self_path():
|
||||
"""這支腳本自己的絕對路徑。**閘印出來的指令一律用它。**
|
||||
|
||||
不用 `sys.argv[0]`：那是「別人怎麼叫我」，被相對路徑叫進來時它就是相對的。
|
||||
`__file__` 走 realpath 是「我是誰」——貼到任何 cwd 底下都指得回同一個檔案。
|
||||
"""
|
||||
return os.path.realpath(__file__)
|
||||
|
||||
|
||||
# 每一段必填欄位的草稿提示。**鍵一定要是 REQUIRED_SECTIONS 裡的字串**——
|
||||
# 對不上也不會漏掉那一段（下面會退成 `<填這裡>`），只是提示變笨。
|
||||
SECTION_HINTS = {
|
||||
"## 目標": "<這件事要達成什麼。寫目的，不要寫做法>",
|
||||
"## 驗收條件": "- [ ] <怎麼算做完——別人可以自己跑一次的那種>",
|
||||
"## deliverable 類型": "code",
|
||||
}
|
||||
|
||||
|
||||
def body_template():
|
||||
"""子票內文的草稿，**用 REQUIRED_SECTIONS 現生**。
|
||||
|
||||
🔴 不要把這段字面寫死：寫死就變成第二份，而 `cmd_subtask` 檢查的是
|
||||
REQUIRED_SECTIONS。有人往那個清單加一段，寫死的模板就會生出一張
|
||||
**照著貼卻過不了自己那道閘**的票 —— 這張票要修的就是這個形狀。
|
||||
"""
|
||||
out = []
|
||||
for sec in REQUIRED_SECTIONS:
|
||||
out.append(sec)
|
||||
out.append(SECTION_HINTS.get(sec, "<填這裡>"))
|
||||
out.append("")
|
||||
return "\n".join(out).rstrip() + "\n"
|
||||
|
||||
|
||||
def subtask_example(parent=None, draft=None):
|
||||
"""可以整段複製貼上的那一塊：先把內文草稿寫出來，再開子票。
|
||||
|
||||
刻意**不放 `--assign`**：`--assign` 沒配 `--next` 會被擋（見 cmd_subtask），
|
||||
而一行印出來卻跑不完的指令，正是這張票在修的病。要指派的人看 USAGE 那份，
|
||||
那裡兩個參數是綁在一起寫的。
|
||||
|
||||
留在 <> 裡的只有三件**機器不可能知道**的事：標題、目標、驗收條件。
|
||||
其餘（腳本路徑、母票、必填段落、標籤）全部已經填好。
|
||||
"""
|
||||
parent = parent or "<母票 owner/repo#N>"
|
||||
draft = draft or "/tmp/subtask-body.md"
|
||||
return (
|
||||
"cat > %s <<'MD'\n" % draft
|
||||
+ body_template()
|
||||
+ "MD\n"
|
||||
+ "%s subtask %s \\\n" % (self_path(), parent)
|
||||
+ ' --title "身為<誰>，我要<什麼>，我才<為什麼>" \\\n'
|
||||
+ " -F %s --label s/todo\n" % draft
|
||||
)
|
||||
|
||||
|
||||
# 🔴 `{bin}` 一定要留成佔位符、由 usage_text() 現填 self_path()：
|
||||
# 用法裡寫死 `ticket` 或 `scripts/ticket`，讀的人照著貼就又踩回這張票的坑。
|
||||
USAGE = {
|
||||
"subtask":
|
||||
"用法：{bin} subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
|
||||
" [--repo <收件 repo，預設跟母票同一個>] [--label <s/xxx，預設 s/todo>]\n"
|
||||
" [--journey <旅程名>] ← 這件事服務哪條使用者旅程（對不上就不要加）\n"
|
||||
" [--assign <誰做> --next \"<他第一件事要做什麼>\"] ← 這兩個是一組，"
|
||||
"指派了就一定要寫下一步\n"
|
||||
"\n（`ticket handoff` 是同一個動作的別名：頂層票 → 下游 repo）",
|
||||
}
|
||||
|
||||
|
||||
def usage_text(verb):
|
||||
"""用法的**唯一**一份，路徑現填成絕對路徑（inkstone/ISEP#112）。"""
|
||||
return USAGE[verb].format(bin=self_path())
|
||||
|
||||
|
||||
def cmd_usage(argv):
|
||||
"""把「用法」與「可以貼著跑的那一塊」交給同一個地方產生（inkstone/ISEP#112）。
|
||||
|
||||
閘的訊息**呼叫這一支**，不自己抄一份 ⇒ 訊息與能跑的指令之間沒有第二份可以漂。
|
||||
"""
|
||||
verbs = "|".join(sorted(USAGE))
|
||||
if not argv or argv[0] not in USAGE:
|
||||
die("用法：ticket usage <%s> [--example] [--parent <owner/repo#N>] "
|
||||
"[--draft <內文檔路徑>]\n"
|
||||
" --example ＝ 印一塊可以整段貼著跑的指令（路徑是絕對路徑，母票已填好）" % verbs)
|
||||
verb = argv[0]
|
||||
|
||||
def opt(name, default=None):
|
||||
return argv[argv.index(name) + 1] if name in argv else default
|
||||
|
||||
if "--example" in argv:
|
||||
if verb != "subtask":
|
||||
die("🚫 `ticket usage %s --example` 還沒有可貼著跑的版本。\n"
|
||||
" 先看用法：ticket usage %s" % (verb, verb))
|
||||
sys.stdout.write(subtask_example(opt("--parent"), opt("--draft")))
|
||||
return
|
||||
sys.stdout.write(usage_text(verb).rstrip() + "\n")
|
||||
|
||||
|
||||
# ── subtask ──────────────────────────────────────────────────────────────
|
||||
def cmd_subtask(argv):
|
||||
"""把「討論串裡的一件事」長成看得見的子票，並掛成母票的 Gitea 原生相依。
|
||||
@@ -737,11 +871,9 @@ def cmd_subtask(argv):
|
||||
不是「新開一條線」——那道閘擋的是後者。
|
||||
"""
|
||||
if len(argv) < 1:
|
||||
die("用法：ticket subtask <母票 owner/repo#N> --title \"<User Story>\" -F <內文檔>\n"
|
||||
" [--repo <收件 repo，預設跟母票同一個>] [--label <s/xxx，預設 s/todo>]\n"
|
||||
" [--journey <旅程名>] ← 這件事服務哪條使用者旅程（對不上就不要加）\n"
|
||||
" [--assign <誰做> --next \"<他第一件事要做什麼>\"] ← 指派了就一定要寫下一步\n"
|
||||
"\n（`ticket handoff` 是同一個動作的別名：頂層票 → 下游 repo）")
|
||||
# 🔴 用法只有 USAGE 那一份（inkstone/ISEP#112）。這裡不准再抄一段：
|
||||
# 抄一段就是又多一個會漂的副本，而閘印的那一行也是從 USAGE 來的。
|
||||
die(usage_text("subtask"))
|
||||
powner, prepo, pnum = parse_ref(argv[0])
|
||||
|
||||
def opt(name, default=None):
|
||||
@@ -830,7 +962,7 @@ def cmd_subtask(argv):
|
||||
print(f" 旅程：`{jlabel}`（母子兩端都貼——只貼一端就聚不起來）")
|
||||
else:
|
||||
print(" 旅程：沒有貼（沒給 --journey）。對得上就補一次："
|
||||
f"`ticket subtask … --journey <旅程名>`；對不上就不要硬湊。")
|
||||
f"`{self_path()} subtask … --journey <旅程名>`；對不上就不要硬湊。")
|
||||
print(f"\n📌 母票 {powner}/{prepo}#{pnum} 目前有 {len(openn)} 張未關的相依：")
|
||||
for i in deps:
|
||||
mark = "◻" if i["state"] == "open" else "☑"
|
||||
@@ -1026,8 +1158,10 @@ def cmd_loose(argv):
|
||||
for d in deps:
|
||||
print(f" ☑ {d['repository']['full_name']}#{d['number']}"
|
||||
f" {d['title'][:52]}")
|
||||
print(f" → 驗過就關：ticket close {full}#{n} --deliverable <URL>")
|
||||
print(f" 還缺東西：ticket subtask {full}#{n} --title \"<US>\" -F <檔>")
|
||||
# 絕對路徑（inkstone/ISEP#112）：相對的 `scripts/ticket` 會被貼到別的 cwd 底下，
|
||||
# 在那裡叫到的可能是本檔的舊複本（`InkStoneCo/scripts/ticket` 就是）。
|
||||
print(f" → 驗過就關：{self_path()} close {full}#{n} --deliverable <URL>")
|
||||
print(f" 還缺東西：{self_path()} subtask {full}#{n} --title \"<US>\" -F <檔>")
|
||||
print()
|
||||
|
||||
print("📌 這張表撈的是**機械事實**（相依邊的 state），不是猜文字。")
|
||||
@@ -1038,7 +1172,8 @@ def cmd_loose(argv):
|
||||
|
||||
CMDS = {"where": cmd_where, "say": cmd_say, "new": cmd_new, "close": cmd_close,
|
||||
"decide": cmd_decide, "subtask": cmd_subtask, "handoff": cmd_subtask,
|
||||
"handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose}
|
||||
"handback": cmd_handback, "mine": cmd_mine, "loose": cmd_loose,
|
||||
"usage": cmd_usage}
|
||||
|
||||
if __name__ == "__main__":
|
||||
if len(sys.argv) < 2 or sys.argv[1] not in CMDS:
|
||||
|
||||
Reference in New Issue
Block a user