create-agentic-dev-env 0.2.1 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -12,6 +12,14 @@
|
|
|
12
12
|
|
|
13
13
|
原則：**預設 context 最小化**——常駐層只寫「何時做＋去哪看」（參考技巧），細節留在本目錄等被載入。用 `ade-add-process` skill 引導整個落地流程。
|
|
14
14
|
|
|
15
|
+
## 流程的結構規則
|
|
16
|
+
|
|
17
|
+
- **禁止孤兒文件**：本目錄的每份文件必須被某支 skill 或 section.md 常駐行引用——沒有指標指到的文件永遠不會在對的時機進入 context，是死知識
|
|
18
|
+
- **執行入口**：每個「有觸發時機、有完成狀態」的流程都要有 skill 作為執行入口；貫穿性約束（如 commit 風格）例外——常駐一行 + 本目錄細節檔即可
|
|
19
|
+
- **大流程拆階段**：步驟多或跨角色的流程，拆成多支**自足**的階段 skill（各自寫明前置條件與產出），另設一支薄的總覽 skill——只放階段地圖與「如何判斷目前進度」，是導航不是執行
|
|
20
|
+
- **狀態外部化**：階段交接的狀態必須落在檔案（如 PRD 狀態欄、spec 的 🚧 標記）；任何階段 skill 開場先讀檔判斷進度，不依賴上一階段的 context 記憶——下一階段可能是新 session、甚至不同的人觸發
|
|
21
|
+
- **Subagent 隔離**：執行痕跡重的階段（大量讀檔、跑指令、探索）交給 subagent 執行、只回傳結論，避免污染主 context
|
|
22
|
+
|
|
15
23
|
## 檔案慣例
|
|
16
24
|
|
|
17
25
|
- 一個主題一個 md 檔，kebab-case 檔名（例：`git-commit.md`、`branching.md`、`release.md`）
|
|
@@ -15,11 +15,14 @@ description: 為團隊建立或修改流程慣例並落地到 ADE 知識庫。
|
|
|
15
15
|
|
|
16
16
|
多數流程是組合：常駐一行（或一支 skill）＋ process 細節檔。
|
|
17
17
|
|
|
18
|
+
**大流程要拆**：步驟多或跨角色的流程，拆成多支自足的階段 skill ＋ 一支薄總覽 skill（只放階段地圖與進度判斷）。階段交接狀態必須外部化到檔案，各階段 skill 開場先讀檔判斷進度；執行痕跡重的階段建議交 subagent 隔離（結構規則詳見 `knowledge/process/README.md`）。
|
|
19
|
+
|
|
18
20
|
## 2. Context 紀律（每一步都遵守）
|
|
19
21
|
|
|
20
22
|
- **參考技巧**：常駐層與 skill body 只寫「何時做＋去哪看」，細節放 process/ 檔按需載入——預設 context 越小越好
|
|
21
23
|
- section.md 常駐規則一條一行；**常駐規則超過 10 行時，新增前必須與使用者確認取捨**（合併、降級為 skill 觸發、或刪一條舊的）
|
|
22
24
|
- skill 的 description 寫觸發語、body 精簡；超過一頁的細節拆到 process/ 檔並連結
|
|
25
|
+
- **禁止孤兒**：新增的 process/ 文件必須被 skill 或常駐行引用，否則它永遠不會進入 context
|
|
23
26
|
|
|
24
27
|
## 3. 落地
|
|
25
28
|
|