create-agentic-dev-env 1.3.2 → 1.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agentic-dev-env",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Scaffold and manage team Agentic Dev Environment (ADE) knowledge repos",
   "repository": {
     "type": "git",

package/template/README.md

@@ -39,7 +39,7 @@ ADE 把這兩件事抽出來共用：
 
 | | 是什麼 | 誰在動它 |
 | --- | --- | --- |
-| **ADE repo**（就是本 repo） | 團隊知識與 skills 的**唯一真相來源**，全隊共用一份。 | 一律走 PR（agent 端由 `ade-contribute` 引導） |
+| **ADE repo**（就是本 repo） | 團隊知識與 skills 的**唯一真相來源**，全隊共用一份。 | 一律走 PR（agent 端由 `ade-contribute` 引導）；[本地模式](#本地模式ade-repo-不放-githubgitlab)沒有 PR，在本 repo 內直接 commit、或由人 merge 回流分支 |
 | **工作目錄**（hub） | 你自己電腦上的一個資料夾，是**開 Claude Code 的起點**。裡面有一份 ADE 的唯讀副本＋全部 skills，底下的 `workspaces/` 放實際要開發的服務 repo。 | 副本不要手改（update 會整個覆蓋）；`workspaces/` 下的服務 repo 照平常方式開發 |
 
 ### 步驟 1：設定 SSH（只做一次）

package/template/skills/ade-contribute/SKILL.md

@@ -11,11 +11,11 @@ description: 從工作目錄修改中央 ADE 知識庫並開 PR（ADE repo 只
 
 1. 讀工作目錄的 `.ade.json` 取得 `source`（ADE repo 的 git url 或本地路徑；為 null 則請使用者補上）。`source` 是檔案系統路徑（`/`、`~`、`.` 開頭或 `file://`）即**本地模式**：ADE repo 不在 GitHub／GitLab，沒有 issue 與 PR，下列標〔本地〕的替代做法適用
 2. **取得工作副本**：`workspaces/<ade-repo-name>/`（repo 名取自 `source`）已存在就直接用，不存在才 `git clone <source>` 到那裡——ADE repo 與服務 repo 一樣放 workspaces，不用 tmpdir，才不會每次重 clone、也保得住未 push 的工作
-   - 開工前 `git fetch origin` 並從最新主幹開分支：`git switch -c <branch> origin/main`
+   - 開工前 `git fetch origin` 並從最新主幹開分支：`git switch -c <branch> origin/HEAD`（`origin/HEAD` 即遠端預設分支，不假設叫 `main`）
 3. **判斷起點**，兩種：
    - **主動撰寫**（使用者明確要求新增或調整 spec、skill、process、服務描述檔）→ 不開 issue，直接進第 4 步
    - **被動回流**（工作中發現知識庫過期或缺漏）→ 先查重：`gh issue list` / `gh pr list`，同一缺口已有記錄就在該 issue/PR 留言補充，到此結束；沒有才開 issue 描述缺什麼／哪裡過期／在哪個工作情境發現的，issue 是查重與追蹤的協調點
-   - 〔本地〕查重改看 `git branch -r` 與 `git log origin/main --oneline -30` 有無同一缺口的分支或 commit；不開 issue，缺口描述（缺什麼／哪裡過期／在哪個情境發現）寫進 commit body；`[upstream-candidate]` 類的機制改良則 append 到 ADE repo 根的 `UPSTREAM-CANDIDATES.md`（同樣走分支）
+   - 〔本地〕查重改看 `git branch -r` 與 `git log origin/HEAD --oneline -30` 有無同一缺口的分支或 commit；不開 issue，缺口描述（缺什麼／哪裡過期／在哪個情境發現）寫進 commit body；`[upstream-candidate]` 類的機制改良則 append 到 ADE repo 根的 `UPSTREAM-CANDIDATES.md`（同樣走分支）
 4. 修改 `knowledge/` 下對應文件
    - 修改前先讀原文，沿用既有格式與詞彙
    - 服務描述檔必須符合 `knowledge/services/_template.yaml` 的欄位結構；收錄範圍遵守 `knowledge/README.md` 的分層規則與「底層原則：Context 管理」（常駐最小、細節分檔按需載入）
@@ -23,4 +23,4 @@ description: 從工作目錄修改中央 ADE 知識庫並開 PR（ADE repo 只
 5. Commit、push 分支，開 PR（GitHub 用 `gh pr create`，GitLab 用 `glab mr create`）；被動回流的 PR 描述加 `Closes #<issue 編號>`
    - gh/glab 不可用或未登入時的降級路徑：push 分支後，把 compare／new-MR 網址給使用者，請人手動開
    - 〔本地〕push 分支即止、不開 PR（非 bare 的本地 repo 也接受 push 到非 checked-out 的分支）；回報分支名與 diff 摘要，**merge 由人在 ADE repo 內執行**（`git -C <source> merge <branch>`），人當場要求才替他跑
-6. 告知使用者 PR 連結（〔本地〕分支名），並把工作副本切回主幹（`git switch main`）留給下次；merge 後在工作目錄執行 update 即可取得新版
+6. 告知使用者 PR 連結（〔本地〕分支名），並把工作副本切回主幹（`git switch <預設分支>`）留給下次；merge 後在工作目錄執行 update 即可取得新版