ship-check 送到得了任何 session:內容原樣搬過來,歸屬寫下來讓機器去比(inkstone/ISEP#122 → comment 6096)
## 這一份是原樣搬過來的,一個字都沒改
skills/ship-check/SKILL.md ← inkstone/InkStoneCo `bd52fa3`(PR #114,**還沒併**)
搬完 md5 f565e4df1b18cc8aaf057f5fa64a9e15,跟來源逐位元組相同(cmp 通過)
595 → 651 行;描述裡多了部落格/GitHub 鏡像/n8n/pages deploy 這些觸發詞
——舊描述那幾個詞**一個都沒有**,所以「我要發一篇部落格文章」那個情境
根本觸發不到它,而那正是 leo 這次要解的問題。
## 為什麼不是「改成指針」也不是「ISEP 不再自帶」
雲端的 project dir 是**薄殼根**,InkStoneCo 只是它底下的一個目錄
(docs/governance/cloud-wiring.md 記著這件事)
⇒ `InkStoneCo/.claude/skills/` 在雲端**不會被載入**,只有 plugin 這一份會
⇒ ISEP 不帶全文 = 雲端拿不到 = 又變回「薄殼是真身的子集」,
而那正是這個 repo 成立時要殺掉的病(README 開頭)。
所以 ISEP 必須帶全文,但它是**搬運工不是作者**:內容改在真相源,這裡只放複本。
## 歸屬不能靠人記得——實查證明兩個方向都會發生
skills/ 與 commands/ 那 9 個檔案在 0.1.0(c263866)從 InkStoneCo 複製過來一次,
之後**再也沒有同步過**(git log 只有那一顆)。到今天已經分家兩個,方向相反:
skills/ship-check/SKILL.md InkStoneCo 651 行 / ISEP 595 行 ← 那邊新
commands/sdd-check.md ISEP 81 行 / InkStoneCo 65 行 ← 這邊新
(InkStoneCo 那份還在教 ISEP#91 已退役的「唯一 active SDD」)
⇒「ISEP 一定比較新」與「InkStoneCo 一定比較新」兩句都是錯的。
這是票上第 4 題「為什麼會有兩份」的答案:不是誰忘了同步,
是**兩份都會被就地編輯**,而沒有任何東西會喊一聲。
## 所以機制是「寫下來 + 讓機器去比」,而且不新開一支閘
- docs/file-ownership.tsv —— 哪一份是真相源、取自哪顆 commit、當時的 sha256
- 比對長在**既有的信標**上(isep-presence-beacon.sh → hooks/lib/beacon_report.py):
它的 ② 已經在做「同名而內容不同」這件事,只是**只掃 scripts/**。
這次把 skills/commands/agents 一起納進去(②b),
再加一格 ②c 用 sha256 單邊驗——**雲端沒有 InkStoneCo 可以比,那是唯一還作數的檢查**。
🔴 刻意不開新閘:ISEP 最常見的錯是重造一支平行的閘
(docs/governance/dispatch-and-reply-format.md §1.6 記著同一課)。
判準是「檔名一樣**而內容不同**」,同步過的不吵——誤攔比漏擋嚴重。
全部只講不擋(SessionStart 本來就不該擋人)。
## 實跑(這棵樹,真的 InkStoneCo)
🟡 會自動載入的東西兩邊各有一份,而且內容不同:
- skills/ship-check/SKILL.md ↔ .claude/skills/ship-check/SKILL.md
(真相源=inkstone/InkStoneCo:… ⇒ 內容改在那裡,改完原樣搬進 ISEP、更新 commit/sha256、升版)
- commands/sdd-check.md ↔ .claude/commands/sdd-check.md
(真相源=ISEP 這一份 ⇒ 專案那份是舊複本,同步過去或刪掉它)
兩個方向各講對了自己的出路。
測試:hooks/tests/isep-presence-beacon.test.sh 14 → 26 條,全綠、全離線。
README/docs/hooks-inventory.md/docs/TESTING.md(A18 改 26 條、新增 A29)都跟著改了。
六個數字在這棵樹上實數:61 支閘/84 條註冊/7 位工人/7 支命令/2 支 skill/49 支腳本
——這次沒有增減,但仍然是數出來的,不是沿用上一版。
(本 commit 也帶著上一顆「逃生門」那件事的兩列文件:hooks-inventory 第 255 列與 TESTING A29。)
🔴 待總管定版:改了會被載入的東西就要升版,否則 plugin update 是 no-op。
🔴 InkStoneCo 那半不是我做的(不同 repo):那邊的 .claude/skills/ 與 .claude/commands/
還留著兩份舊複本,該同步或刪掉;在那之前信標會每次開場點名它們。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
+68
-12
@@ -1,18 +1,21 @@
|
||||
---
|
||||
name: ship-check
|
||||
description: |
|
||||
改完任何會影響用戶的東西之後、說「做完了」之前必讀(改雲端 worker/portal/daemon/
|
||||
workflow/installer 都算)。也在下列時機自動載入:要打包 App、要出貨、要推 bundle、
|
||||
要送 MS Store、leo 問「可以測了嗎」「版本為什麼沒變」「更新了嗎」「封測者拿得到嗎」。
|
||||
核心判準:**版本號是 leo 唯一的驗收介面**——portal 版本卡看雲端、daemon 檢查更新看桌面;
|
||||
版本沒動=他無從判斷你做了什麼=等於沒交付,而「我在某台實例 wrangler deploy 過了」不算。
|
||||
收齊:兩條版本線的差別/重打 bundle(最常漏,要 grep 複驗改動真的進去)/
|
||||
改 workflow 要重編預編圖/三支機械閘+把 DMG/zip 真的打開檢查/寫 changelog(用戶語言)/
|
||||
D20 開閘出貨/purge jsDelivr/從 leo 會看的那兩處抓實際畫面複驗。
|
||||
附「常見漏掉的」實撞表與收工前五問。
|
||||
**任何東西要從「內」(Gitea)送到「外」之前必讀**——不只是 arcrun。
|
||||
對外包含:發一篇部落格文章到 uncle6.me、推 tag 到 GitHub 鏡像 repo、投稿 n8n 官方模板庫、
|
||||
出雲端零件包、出桌面 daemon。也在下列時機自動載入:改完會影響用戶的東西之後、
|
||||
要打包 App/出貨/推 bundle/送 MS Store、要發文、要 pages deploy、要推 GitHub、
|
||||
leo 問「可以測了嗎」「版本為什麼沒變」「更新了嗎」「封測者拿得到嗎」「發出去了嗎」。
|
||||
🔴 第一個動作是**分辨這是哪個出口**,因為 stage/版本/arm 每個出口都不同——
|
||||
流程本體住在 system-dev/docs/3-specs/critical-paths/ship.md(唯一一份),本 skill 是它的入口。
|
||||
核心判準:**收的人拿到的東西真的變了,而且他看得出變了什麼**;
|
||||
對 arcrun 兩條線而言那個介面就是版本號(portal 看雲端、daemon 看桌面)。
|
||||
收齊:五個出口的判準/兩條版本線的差別/重打 bundle(最常漏)/改 workflow 要重編預編圖/
|
||||
三支機械閘+把 DMG/zip 真的打開檢查/寫 changelog/D20 開閘出貨/purge jsDelivr/
|
||||
從收的人會看的那個地方抓實際畫面複驗。附「常見漏掉的」實撞表與收工前五問。
|
||||
---
|
||||
|
||||
# /ship-check — 改完東西後,讓 leo 看得到版本變了
|
||||
# /ship-check — 東西要出去之前,先確定收的人真的會拿到
|
||||
|
||||
> **這支解什麼病**(leo 2026-08-05 原話):
|
||||
> 「對人來說,**我雲端看 portal 有沒有更新,本地看 daemon 有沒有更新**,
|
||||
@@ -25,6 +28,44 @@ description: |
|
||||
|
||||
---
|
||||
|
||||
## 🚦 第一步:這是哪個出口?(2026-09-02 補,`inkstone/InkStoneCo#112`)
|
||||
|
||||
> **為什麼補這段**(leo 2026-09-02):「Gitea 為『內』,只要對外都是『外』,
|
||||
> **任何東西出去之前都要經過出貨流程,不是只有 Arcrun, Arcrun RAG 這個計劃**」
|
||||
>
|
||||
> 🔴 **這支 skill 2026-09-01 失效過**:它自己與它指向的地方**只認得 daemon 那個形狀**,
|
||||
> 於是那晚要發部落格與 GitHub 模板時,它沒把人導向任何可用的流程——**只好即興補**。
|
||||
|
||||
- 🔴 **流程本體只有一份**:`system-dev/docs/3-specs/critical-paths/ship.md`
|
||||
- 它定義了**內/外的判準**、**六個步驟**、**五個出口各自的 stage/版本/arm/驗法**
|
||||
- **動手前先讀那一卷的對應出口段**,不要憑本 skill 的印象做
|
||||
- **判準一句:送出去之後,有沒有一個不是我們的人看得到/拿得到?** 有 ⇒ 走那六步
|
||||
- **五個出口,各自去 `ship.md` 的哪一段**:
|
||||
- ① 桌面 daemon(`v0.18.x`)——**本 skill 底下的內容主要是它與 ②**
|
||||
- ② 雲端零件包(`1.4.x`)——同上
|
||||
- ③ 部落格 uncle6.me — 🔴 **沒有 arm、沒有版本號**,stage 是 `<8碼>.kbcontent.pages.dev` 快照;
|
||||
`pages deploy` **必須在 repo 外的目錄跑**,否則 `.env` 的 token 會蓋掉 OAuth 並報成權限錯誤
|
||||
|**驗法是瀏覽器,不是 `curl`**(收件人是讀者 ⇒ 見 §5.8 與 `ship.md` 出口③「驗法」)
|
||||
- ④ GitHub 鏡像 repo — 🔴 **要 arm,而且連 `git remote add` 都擋**(D20);
|
||||
Gitea 就是它的 stage;**推 tag 之外還要發 release note**
|
||||
(怎麼發、要不要再 arm ⇒ `ship.md` 出口④ 的「release note 怎麼發」段)
|
||||
- 🔴 **步驟 3 的「Use this template」也要 arm,而且要單獨請一次**——它建的是
|
||||
**第二個 repo**,撞 ROE「單一 repo」那條,夾不進推 tag 的窗口。
|
||||
且 guard 只掛在 `Bash` ⇒ **走瀏覽器按那顆按鈕不會被擋,這條靠人守**
|
||||
(⇒ `ship.md` 出口④ 的「Use this template 要不要 arm」段)
|
||||
- ⑤ n8n 官方投稿 — 沒有 stage,投稿端點尚未查到(`inkstone/llm-wiki-template#9`)
|
||||
- 🔴 **不要拿 ① 的答案去套 ③④⑤**——那正是 2026-09-01 出錯的機制
|
||||
- 🔴 **「這個出口沒有 arm」不等於「這個出口不必經過 leo」**——③⑤ 的人閘是**步驟 5**
|
||||
(leo 親手在 stage 上走過那一遍)。判準全文=`ship.md` 的
|
||||
「誰批准、誰按鍵、在哪台跑」段:**leo 批准,機器執行**
|
||||
- **跨多個 repo 的一批貨,「100%」看母票的相依清單,不要看 milestone 的百分比**
|
||||
(milestone 只數 hub 那個 repo,別的 repo 那幾張不在分母裡)
|
||||
⇒ `ship.md` 的「那個數字看哪裡」段
|
||||
- 🔴 **發現 `ship.md` 沒涵蓋你手上這件事 ⇒ 那一卷缺了一格,回去補它**,
|
||||
不要在別處另開一份流程(leo 2026-09-02 明確選了「改寫 ship.md」)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 這支 skill 自己的失效模式(先讀這段)
|
||||
|
||||
leo 2026-08-05:「**你寫完一個 skill 然後每個我要提醒你,表示這個 skill 無效**」
|
||||
@@ -44,8 +85,19 @@ leo 2026-08-05:「**你寫完一個 skill 然後每個我要提醒你,表示
|
||||
|
||||
## 什麼時候跑
|
||||
|
||||
**改完任何會影響用戶的東西之後**(雲端 worker/portal/daemon/workflow),
|
||||
在說「做完了」之前。不是收工才跑。
|
||||
**任何東西要送到「外面」之前**——改完會影響用戶的東西、要發一篇文章、要推 tag 到 GitHub、
|
||||
要投稿、要出零件包或 daemon。在說「做完了」之前跑,不是收工才跑。
|
||||
|
||||
⚠️ **底下的步驟是出口①②(arcrun 兩條版本線)的細節。**
|
||||
出口③④⑤ 請照上面那段回 `ship.md` 讀該出口的判準——**它們沒有版本號卡可以看**。
|
||||
|
||||
🔴 **但底下 §5.8「驗前端=用瀏覽器真的載一次」是全出口通則,不歸①② 所有**
|
||||
(2026-09-02 補:本 skill 這句劃界曾把 §5.8 圈進①②,
|
||||
而 `ship.md` 對出口③ 給的驗法是 `curl` ⇒ **兩個檔對同一個問題給了兩種答案**)。
|
||||
- **一句話判準:用收的人的那個介面驗。**
|
||||
- 收的人的介面是**網頁** ⇒ 瀏覽器(出口③ 讀者、出口① 的 portal 版本卡)
|
||||
- 收的人的介面是 **API/CLI** ⇒ `curl` 才是對的(出口② 的 `/health`,程式在讀它)
|
||||
- ⇒ 這不是「①② 用 curl、③ 用瀏覽器」,是**每個出口各自問自己的收件人在看什麼**
|
||||
|
||||
---
|
||||
|
||||
@@ -503,6 +555,10 @@ curl -s "https://rag.arcrun.dev/docs/start/install-windows/?cb=$RANDOM" \
|
||||
|
||||
> leo 原話:「**你的環境有 web,你應該用 web 驗,你已經開啓了卻沒有完成,你要把這個列入規定。**」
|
||||
|
||||
🔴 **適用範圍:全出口,不是只有①②**(2026-09-02 補,見上面「什麼時候跑」那段的劃界)。
|
||||
**收的人的介面是網頁就套這條**——出口③ 部落格的收件人是讀者,他的介面就是瀏覽器。
|
||||
`ship.md` 出口③「驗法」那格寫的是同一件事,兩邊只有一種說法。
|
||||
|
||||
**為什麼 `curl | grep` 是假驗證**(08-08 實撞,leo 抓到而不是我發現):
|
||||
`curl` 拿到的是 **HTML 原始碼**——它**不執行 JS、不載入 `config.js`、不發 API 請求**。
|
||||
所以我 grep 到文案就宣稱「前端驗過」,而使用者實際打開看到的是整條紅色錯誤:
|
||||
|
||||
Reference in New Issue
Block a user