@moon791017/neo-skills 1.1.30 → 1.1.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moon791017/neo-skills",
-  "version": "1.1.30",
+  "version": "1.1.31",
   "type": "module",
   "description": "Neo Skills: A Universal AI Agent Skills Extension",
   "homepage": "https://neo-blog-iota.vercel.app/",

package/skills/neo-harness-project/SKILL.md

@@ -26,7 +26,7 @@ metadata:
 
 ### 1. 盤點，不寫入
 
-先讀取專案規範、版本控制狀態、根目錄、套件與建置設定、測試、CI、文件、主要入口及現有 Harness 資產。所有命令都必須從可驗證的設定或文件取得，不可憑技術棧猜測。
+先讀取專案規範、版本控制狀態、根目錄、套件與建置設定、測試、CI、文件、主要入口及現有 Harness 資產，包含 `docs/scripts.md` 與 `docs/exec-plans/` 的既有檔案。所有命令都必須從可驗證的設定或文件取得，不可憑技術棧猜測。
 
 盤點時必須閱讀 [專案評估模型](references/project-assessment.md)，以來源證據判定成熟度與缺口。未知資訊標成「未知」，不要補成理想狀態。
 
@@ -40,7 +40,7 @@ metadata:
 - `skip`：沒有需求或證據，不建立。
 - `blocked`：缺少關鍵事實或違反中立要求。
 
-核心知識與計畫資產預設納入；CI、架構檢查、執行環境、可觀測性與持續清理只在矩陣條件成立時納入。
+核心知識、命令清單與計畫資產預設納入；CI、架構檢查、執行環境、可觀測性與持續清理只在矩陣條件成立時納入。
 
 ### 3. 提供寫入預覽
 
@@ -61,19 +61,26 @@ metadata:
 - 只修改預覽中已確認的精確路徑。
 - `rebuild` 必須保留仍正確的專案事實，並確保可從版本控制或已報告的暫存快照復原。
 - 空的執行計畫目錄使用最小追蹤檔保存，不填入虛構計畫。
+- 新建立的執行計畫檔名必須使用 `YYYYMMDDHHmmss_<原計畫檔名>.md`；時間戳取建立當下執行環境的本地時間，從 `active` 移至 `completed` 時保留原時間戳。
+- 既有未加時間戳的計畫不批次改名；更新既有計畫時沿用原檔名。
+- `docs/scripts.md` 必須是只含 `指令`、`用途` 兩欄的 Markdown table，收錄所有可由專案設定或文件驗證的命令；沒有可驗證命令時只保留空表頭。
+- 沒有可驗證的統一驗證命令時，從 `AGENTS.md` 移除統一驗證命令與相應完成條件，不保留模板標記。
 - 規則可被機器可靠判斷時，優先使用既有工具形成可執行檢查；否則保留為明確文件規則。
 
 ### 5. 閉環驗證
 
 1. 確認所有建立或重建的檔案都在已確認清單中。
 2. 檢查文件連結、命令、路徑、架構描述及模板標記。
-3. 執行專案原有快速檢查與新增的統一驗證入口。
-4. 失敗時閱讀完整錯誤、修正根因並重跑。
-5. 回報實際產出、未解缺口、命令與結果；沒有通過證據不得宣告完成。
+3. 驗證新計畫檔名的時間戳格式，以及 `docs/scripts.md` 的兩欄 Markdown table 格式。
+4. 執行專案原有快速檢查與新增的統一驗證入口。
+5. 失敗時閱讀完整錯誤、修正根因並重跑。
+6. 回報實際產出、未解缺口、命令與結果；沒有通過證據不得宣告完成。
 
 ## 完成條件
 
 - 核心資產可由新工作階段只靠目前專案找到必要知識、限制與驗證方法。
+- `docs/scripts.md` 提供完整且可追溯的專案命令清單。
+- 新建立的計畫檔案可依時間戳前綴排序，且計畫生命週期移動不改變前綴。
 - 所有命令均可追溯到專案設定且可實際執行。
 - 沒有假成功命令、未完成模板、虛構架構或未經確認的重建。
 - 條件式資產都有專案證據，未選用項目都有可說明的原因。

package/skills/neo-harness-project/assets/templates/AGENTS.md.template

@@ -15,13 +15,14 @@
 | :--- | :--- |
 | 架構 | `ARCHITECTURE.md` |
 | 執行計畫 | `docs/exec-plans/` |
+| 專案指令 | `docs/scripts.md` |
 | {{KNOWLEDGE_TOPIC}} | `{{KNOWLEDGE_PATH}}` |
 
 ## 命令
 
-| 用途 | 精確命令 |
-| :--- | :--- |
-| {{COMMAND_PURPOSE}} | `{{VERIFIED_COMMAND}}` |
+完整命令清單：`docs/scripts.md`
+
+統一驗證命令：`{{CANONICAL_VERIFY_COMMAND}}`
 
 ## 工作閉環
 

package/skills/neo-harness-project/assets/templates/PLANS.md.template

@@ -6,6 +6,8 @@
 
 進行中計畫放在 `docs/exec-plans/active/`；完成且已記錄結果的計畫移至 `docs/exec-plans/completed/`。
 
+新建立的執行計畫檔名使用 `YYYYMMDDHHmmss_<原計畫檔名>.md`。時間戳取建立當下執行環境的本地時間，計畫移至 `completed` 時沿用原時間戳。既有未加時間戳的計畫不批次改名。
+
 每份計畫必須自包含。讀者只需要目前工作樹與計畫本身，不應依賴先前對話或未連結的外部資訊。
 
 ## 必要內容

package/skills/neo-harness-project/assets/templates/scripts.md.template

@@ -0,0 +1,2 @@
+| 指令 | 用途 |
+| :--- | :--- |

package/skills/neo-harness-project/evals/eval_queries.json

@@ -2,6 +2,7 @@
   "should_trigger": [
     "請盤點目前 repository，建立完整且可自行驗證的 Harness 工程環境",
     "幫這個專案補齊架構文件、長任務計畫、統一驗證入口與必要目錄",
+    "調整 Harness 的計畫檔名排序規則，並整理專案命令到 docs/scripts.md",
     "Assess this repository and build an evidence-based project harness with persistent plans and validation gates",
     "重建目前專案的 Harness 文件，但先列出會覆寫的檔案給我確認",
     "檢查現有工程環境的成熟度，並依實際工具補齊缺少的治理資產"

package/skills/neo-harness-project/evals/evals.json

@@ -4,13 +4,15 @@
     {
       "id": 1,
       "prompt": "請針對目前的 Node.js 專案建立完整 Harness。package.json 只有 test 與 build scripts，專案目前沒有任何治理文件。",
-      "expected_output": "先提供唯讀盤點與精確寫入預覽，不立即建立檔案。核心資產應納入，驗證入口只能組合實際存在的 test 與 build，沒有證據的 CI、可觀測性或架構檢查應略過。",
+      "expected_output": "先提供唯讀盤點與精確寫入預覽，不立即建立檔案。核心資產應納入，包含以時間戳命名規則管理的執行計畫與兩欄命令表；驗證入口只能組合實際存在的 test 與 build，沒有證據的 CI、可觀測性或架構檢查應略過。",
       "assertions": [
         "確認前沒有修改任何檔案",
         "預覽列出每個精確路徑、動作、證據、驗證與復原方式",
         "只採用 package.json 實際存在的 test 與 build 命令",
         "不虛構 lint、typecheck、CI、可觀測性或架構工具",
-        "核心資產包含知識地圖、目前架構、計畫規範與執行計畫目錄"
+        "核心資產包含知識地圖、目前架構、計畫規範、docs/scripts.md 與執行計畫目錄",
+        "新建立的執行計畫使用 YYYYMMDDHHmmss_ 前綴，移至 completed 時保留前綴",
+        "docs/scripts.md 僅使用 指令 與 用途 兩欄並只收錄可驗證命令"
       ]
     },
     {
@@ -56,6 +58,18 @@
         "受影響資產標記為 blocked",
         "未受衝突影響的盤點仍可繼續"
       ]
+    },
+    {
+      "id": 6,
+      "prompt": "專案已有未加時間戳的 active 計畫與數個散落在設定及文件中的實際命令。請補齊 Harness 導航與命令文件，但不要未經確認批次改名。",
+      "expected_output": "保留既有計畫檔名與連結；新計畫使用本地時間的 14 位數字前綴，建立只含指令與用途兩欄的 docs/scripts.md，並將所有有來源證據的命令集中整理。",
+      "assertions": [
+        "既有未加前綴的計畫不直接改名",
+        "新計畫檔名符合 YYYYMMDDHHmmss_<原計畫檔名>.md",
+        "計畫移動至 completed 時保留原時間戳",
+        "docs/scripts.md 是只含 指令 與 用途 兩欄的 Markdown table",
+        "未經專案設定或文件驗證的命令不加入 scripts.md"
+      ]
     }
   ]
 }

package/skills/neo-harness-project/references/artifact-selection.md

@@ -7,6 +7,7 @@
 | 路徑 | 目的 | 建立規則 |
 | :--- | :--- | :--- |
 | `AGENTS.md` | 短小的專案知識地圖、精確命令、工作規則與完成條件 | 一律評估；存在時依確認結果更新或重建 |
+| `docs/scripts.md` | 保存專案所有已驗證命令及用途 | 一律評估；不存在時建立，存在時保留有效內容並補齊已驗證命令 |
 | `ARCHITECTURE.md` | 記錄目前元件、責任、依賴方向、邊界與可執行約束 | 一律評估；未知架構明確標示，不畫理想架構 |
 | `PLANS.md` | 定義何時使用持久計畫、必要章節及生命週期 | 一律評估；沿用專案既有計畫命名時同步調整連結 |
 | `docs/exec-plans/active/` | 保存進行中且可由新工作階段接續的計畫 | 沒有現行計畫時只建立最小追蹤檔 |
@@ -14,6 +15,18 @@
 
 若專案已有等價且被廣泛引用的路徑，優先更新知識地圖指向既有來源，不平行建立第二套真相來源。
 
+## 計畫檔名
+
+- 新建立的執行計畫放在 `docs/exec-plans/active/` 或 `docs/exec-plans/completed/` 時，檔名使用 `YYYYMMDDHHmmss_<原計畫檔名>.md`。
+- `YYYYMMDDHHmmss` 是建立當下執行環境本地時間的 14 位數字；移動計畫時保留原時間戳。
+- 不符合格式的既有計畫保留原檔名，不執行未經確認的批次改名。
+
+## `scripts.md` 產出規則
+
+- `docs/scripts.md` 只能包含 Markdown table，欄位固定為 `指令` 與 `用途`；既有檔案格式不符時標成 `rebuild`，保留仍有證據的命令資料並移除無法驗證的列。
+- 命令必須逐一追溯到套件設定、工作執行器、CI 或版本控制內文件；不得依技術棧推測。
+- 沒有可驗證命令時仍建立只有表頭與分隔列的空表格。
+
 ## 統一驗證入口
 
 只有至少一個真實且可重複的檢查存在時才建立或補強統一入口。選擇順序：

package/skills/neo-harness-project/references/generation-validation.md

@@ -8,10 +8,18 @@
 
 - 保持短小，作為知識地圖而不是完整手冊。
 - 指向架構、計畫、設計、可靠性、安全與品質的實際來源。
-- 只列出已從設定驗證的安裝、開發、測試、靜態檢查、建置與統一驗證命令。
+- 以 `docs/scripts.md` 作為完整命令清單來源；只在 `AGENTS.md` 保留該文件連結與已驗證的統一驗證命令捷徑。
+- 沒有可驗證的統一驗證命令時，移除統一驗證命令行與完成條件中的 `{{CANONICAL_VERIFY_COMMAND}}`，不得保留模板標記或填入假命令。
 - 寫明開始工作、失敗修正、審查及完成條件。
 - 大型細節移到連結文件，檔案不得超過 32 KiB。
 
+### `docs/scripts.md`
+
+- 檔案只能是 Markdown table，第一列固定為 `| 指令 | 用途 |`，第二列為兩欄分隔列。
+- 每個資料列只能有兩欄；命令與用途都必須來自專案設定或版本控制內文件的可驗證證據。
+- 收錄專案實際會使用的安裝、開發、測試、靜態檢查、建置、啟動、部署及統一驗證命令；沒有證據的命令不得加入。
+- 沒有任何可驗證命令時，保留表頭與分隔列，不填入未知或虛構命令。
+
 ### `ARCHITECTURE.md`
 
 - 描述目前系統，不描述尚未存在的目標系統。
@@ -24,6 +32,8 @@
 
 - 定義需要持久計畫的門檻，例如多階段、跨模組、遷移、陌生領域或可能跨工作階段的任務。
 - 每份計畫必須自包含；假設讀者只有目前工作樹與計畫本身。
+- 新建立的計畫檔名使用 `YYYYMMDDHHmmss_<原計畫檔名>.md`；時間戳取本地時間，從 `active` 移至 `completed` 時沿用。
+- 既有未加時間戳的計畫不批次改名；更新既有計畫時維持原檔名與既有連結。
 - 計畫至少涵蓋目的、背景、目前與期望行為、限制、工作順序、進度、發現、決策、具體步驟、驗證、復原及結果。
 - 實作期間同步更新進度、發現與決策；完成後記錄結果並移至 completed。
 
@@ -51,6 +61,8 @@
 - [ ] 寫入路徑完全符合確認清單。
 - [ ] 所有模板標記都已替換或移除。
 - [ ] 文件內相對路徑存在，或明確標成尚未建立的核准計畫。
+- [ ] 新建立的計畫檔案符合 14 位數字時間戳、底線、原檔名與 `.md` 副檔名格式。
+- [ ] `docs/scripts.md` 只包含 `指令`、`用途` 兩欄，且每個命令都有來源證據。
 - [ ] 命令可從專案設定追溯，且未使用虛構旗標。
 - [ ] 架構敘述與程式碼、設定及測試一致。
 - [ ] 統一驗證會傳遞失敗狀態，且沒有空殼成功步驟。