@laitszkin/apollo-toolkit 3.14.2 → 3.14.4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this repository are documented in this file.
 
+## [v3.14.4] - 2026-05-16
+
+### Changed
+
+- Standardize spec template task numbering (P1.x/P2.x, T1.x/T2.x) and simplify SKILL.md description format across skill docs.
+
+## [v3.14.3] - 2026-05-15
+
+### Changed
+
+- Consistently use "並行調度 subagents" wording across 9 SKILL.md to clarify that subagents should be dispatched in parallel.
+
 ## [v3.14.2] - 2026-05-15
 
 ### Fixed

package/align-project-documents/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: align-project-documents
-description: 整理及維護項目文檔。當你需要管理項目說明文檔時，使用此技能。
+description: >-
+    提供標準化的文檔格式，用於協助維護項目文檔。
+    使用場景：更新、修改、重寫項目文檔。
 ---
 
 ## 目標
@@ -21,17 +23,11 @@ description: 整理及維護項目文檔。當你需要管理項目說明文檔
 ### 2. 比對repo及項目文檔
 
 按照上一步建立的閱讀策略，全面搜索、查找整個repo，驗證並確保現有項目文檔的描述正確、無遺漏。
-如果外部環境存在subagents功能，建議調度subagents完成對repo的閱讀。
+如果外部環境存在 subagents 功能，建議通過並行調度 subagents 完成對repo的閱讀。
 
 ### 3. 制定文檔更新策略
 
-根據上一步找到的所有遺漏或項目文檔與實際代碼脫節之處，制定文檔更新策略。將所有項目文檔更新為符合模板格式的標準化文檔，並移除除必要文檔（如 `CHANGELOG.md`, `CONTRIBUTION.md` ）外的舊有說明文檔。
-
-## 範例
-
-- "根據當前repo重建整套專案文檔。" -> "完整讀碼後重建三類標準文檔，清理舊文檔並同步刷新 `AGENTS.md` / `CLAUDE.md`。"
-- "這個倉庫的 docs 很散，請重新對齊成統一結構。" -> "把可保留內容遷入 `docs/features/`、`docs/architecture/`、`docs/principles/`，移除重複或失效文件。"
-- "我要的不是 README 小修，而是整個文檔體系重整。" -> "以全倉庫證據為基礎重建標準化文檔樹，而不是只修改單一說明文件。"
+根據上一步找到的所有遺漏或項目文檔與實際代碼脫節之處，制定文檔更新策略。使用模板之中所規範的格式，重寫項目文檔，並移除除必要文檔（如 `CHANGELOG.md`, `CONTRIBUTION.md` ）外的舊有說明文檔。
 
 ## 參考資料
 - `references/templates/standardized-docs-template.md` - 三類文檔的目標結構、分類規則與清理檢查表。

package/develop-new-features/SKILL.md

@@ -21,7 +21,7 @@ description: 用於從零開始打造新專案。當你需要從零開始打造
 ### 2. 實作spec
 
 在明確獲取用戶的同意之後，使用 `implement-specs` 技能實作spec。
-如果spec是batch spec（存在多份spec），且外部環境允許使用subagents，建議使用 `implement-specs-with-subagents` 技能調度subagents實作spec。
+如果spec是batch spec（存在多份spec），且外部環境允許使用subagents，建議使用 `implement-specs-with-subagents` 技能並行調度 subagents 實作spec。
 
 ## 使用範例
 

package/generate-spec/SKILL.md

@@ -18,7 +18,7 @@ description: 當你需要將用戶模糊的複雜需求拆解成有嚴格實作
 ### 1. 理解用戶需求並閱讀repo
 
 分析用戶需求，並在 repo 之中搜索、列出可能相關的內容。完成搜索之後，深入閱讀相關代碼，識別變更範圍。
-如果外部環境存在 subagents 功能，建議通過調度 subagents 來完成深入閱讀 repo 的任務。
+如果外部環境存在 subagents 功能，建議通過並行調度 subagents 來完成深入閱讀 repo 的任務。
 
 ### 2. 拆分用戶需求及設計業務架構
 

package/generate-spec/references/templates/preparation.md

@@ -3,26 +3,16 @@
 - Date: [YYYY-MM-DD]
 - Batch: [batch_name]
 
-## Preparation Goal
-
-[Describe the smallest shared prerequisite state that must exist before member specs can be implemented in parallel. This must not implement core business logic or deliver the batch target outcome.]
-
-- Why this exists: [why the batch cannot be parallelized without this prerequisite work]
-- Core business boundary: [No core business logic or target outcome is implemented here]
-- Depends on (specs): [[spec-name-1], [spec-name-2]]
-- Parallel work starts after: [commit / verification / approval of this preparation]
-- Out of scope: [member-spec implementation work that must remain in spec files]
-
 ## **Task P1: [Preparation Task Title]**
 
 Purpose: [why this prerequisite is required before parallel work]
 Scope: [files/modules this task may touch]
 Out of scope: [core business logic, target outcome, member-spec behavior]
 
-- P1. [ ] **[file/function]** — **[specific modification; expected output]**
+- P1.1 [ ] **[file/function]** — **[specific modification; expected output]**
   - Verify: [command/check/manual inspection]
 
-- P2. [ ] **[file/function]** — **[specific modification; expected output]**
+- P1.2 [ ] **[file/function]** — **[specific modification; expected output]**
   - Verify: [command/check/manual inspection]
 
 ## **Task P2: [Preparation Task Title]**
@@ -31,10 +21,10 @@ Purpose: [why this prerequisite is required before parallel work]
 Scope: [files/modules this task may touch]
 Out of scope: [core business logic, target outcome, member-spec behavior]
 
-- P1. [ ] **[file/function]** — **[specific modification; expected output]**
+- P2.1 [ ] **[file/function]** — **[specific modification; expected output]**
   - Verify: [command/check/manual inspection]
 
-- P2. [ ] **[file/function]** — **[specific modification; expected output]**
+- P2.2 [ ] **[file/function]** — **[specific modification; expected output]**
   - Verify: [command/check/manual inspection]
 
 ## Validation
@@ -42,11 +32,3 @@ Out of scope: [core business logic, target outcome, member-spec behavior]
 - Verification required: [commands/checks before subagents start]
 - Expected results: [what proves the prepared baseline is usable]
 - Regression risks covered: [risk IDs or behavior slices]
-
-## Handoff
-
-- Preparation commit required before parallel work: [Yes / No]
-- Member specs assume: [prepared baseline assumptions]
-- Member specs must not change: [prepared surfaces now frozen or additive-only]
-- Member specs own all business behavior: [Yes]
-- If preparation changes later: [stop and re-coordinate rule]

package/generate-spec/references/templates/tasks.md

@@ -10,10 +10,10 @@ Requirements: [R1.x]
 Scope: [files/modules/functions this task may touch]
 Out of scope: [files/modules/behaviors this task must not change]
 
-- 1. [ ] **[file/function]** — **[specific modification to make; expected outcome]**
+- T1.1 [ ] **[file/function]** — **[specific modification to make; expected outcome]**
   - Verify: [focused command/check/manual inspection; drift check ref if applicable]
 
-- 2. [ ] **[file/function]** — **[specific modification to make; expected outcome]**
+- T1.2 [ ] **[file/function]** — **[specific modification to make; expected outcome]**
   - Verify: [focused command/check/manual inspection; drift check ref if applicable]
 
 ## **Task 2: [Task Title]**
@@ -23,22 +23,8 @@ Requirements: [R2.x]
 Scope: [files/modules/functions this task may touch]
 Out of scope: [files/modules/behaviors this task must not change]
 
-- 1. [ ] **[file/function]** — **[specific modification to make; expected outcome]**
+- T2.1 [ ] **[file/function]** — **[specific modification to make; expected outcome]**
   - Verify: [focused command/check/manual inspection; drift check ref if applicable]
 
-- 2. [ ] **[file/function]** — **[specific modification to make; expected outcome]**
+- T2.2 [ ] **[file/function]** — **[specific modification to make; expected outcome]**
   - Verify: [focused command/check/manual inspection; drift check ref if applicable]
-
-## Notes
-- **Layering:** **`design.md`** / **`contract.md`** are **guiding context** only (architecture + external truth). **`tasks.md` is the sole numbered, file-level execution queue**—do not expect design/contract to re-list its checkboxes.
-- When drafting, derive task order and scope from **`spec.md`** + **`design.md`** + **`contract.md`**; optionally cite **`INT-###` / `EXT-###`** on rows those anchors constrain.
-- Task order reflects implementation sequence.
-- Every task must map back to `spec.md` requirement IDs.
-- Treat `tasks.md` as an implementation queue, not a summary.
-- Each item must include the exact file path (or function/module), the specific change, and a concrete verification step — vague items are forbidden.
-- Each checkbox is atomic: one verb, one file/function, one change outcome, one verification hook.
-- Use `N.x [ ]` for sub-items only when a parent item needs further breakdown.
-- Split tasks that exceed 3 files or span multiple behavior slices.
-- Use `$test-case-strategy` for drift checks before implementation.
-- After execution, update `[x]` for done, `[ ]` for pending.
-- Remove all `[...]` placeholder text after filling.

package/init-project-html/SKILL.md

@@ -16,7 +16,7 @@ description: 當你需要為項目初始化架構圖時，使用此技能。
 ### 1. 閱讀並理解代碼庫
 
 按照功能模塊的定義，全面檢索並將代碼庫拆分為單個或多個功能模塊。接著，開始對功能模塊下的子模塊進行識別及深度閱讀。
-如果外部環境允許使用 subagents ，建議為每一個功能模塊分配一個 subagents 進行深度閱讀，並要求 subagents 完整列出：
+如果外部環境允許使用 subagents ，建議並行調度 subagents，並為每一個功能模塊分配一個 subagent 進行深度閱讀，要求 subagents 完整列出：
 - 該功能模塊與其他功能模塊之間是否存在交互；如有，如何交互。
 - 該功能模塊內部存在哪些子模塊，這些子模塊之間如何交互並實現功能模塊的功能。
 - 該功能模塊及下屬子模塊的資料流、錯誤處理。

package/maintain-project-constraints/SKILL.md

@@ -16,7 +16,7 @@ description: 當你需要更新 `CLAUDE.md` 或 `AGENTS.md` 這兩份項目規
 ### 1. 閱讀 repo
 
 深入閱讀當前項目文檔及實作代碼，並建立對於項目的全面認知。
-如果外部環境允許使用 subagents，建議通過調度 subagents 完成對 repo 代碼的深入閱讀。
+如果外部環境允許使用 subagents，建議通過並行調度 subagents 完成對 repo 代碼的深入閱讀。
 
 ### 2. 更新項目規範文檔
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laitszkin/apollo-toolkit",
-  "version": "3.14.2",
+  "version": "3.14.4",
   "description": "Apollo Toolkit npm installer for managed skill copying across Codex, OpenClaw, and Trae.",
   "license": "MIT",
   "author": "LaiTszKin",

package/review-spec-related-changes/SKILL.md

@@ -16,7 +16,7 @@ description: 當你需要審查規格文檔相關變更時，調用此技能
 ### 1. 建立審查範圍
 
 閱讀用戶指定的 spec ，並按照 spec 之中定義的實作範圍，檢索並閱讀相關代碼。
-如果外部環境允許使用 subagents，建議通過調度 subagents 完成代碼的深度閱讀。
+如果外部環境允許使用 subagents，建議通過並行調度 subagents 完成代碼的深度閱讀。
 
 ### 2. 進行多維度審查
 
@@ -29,7 +29,7 @@ description: 當你需要審查規格文檔相關變更時，調用此技能
 - 無性能隱患
 
 如果有代碼違反了上述6個原則，將他們紀錄在案。
-如果外部環境允許使用 subagents，建議通過調度 subagents 完成對代碼的多維度審查，每一個 subagent 審查一個維度。
+如果外部環境允許使用 subagents，建議通過並行調度 subagents 完成對代碼的多維度審查，每一個 subagent 審查一個維度。
 
 ### 3. 生成 code review report
 

package/solve-issues-found-during-review/SKILL.md

@@ -16,7 +16,7 @@ description: 當你需要修復 code review report 之中發現的問題時，
 ### 1. 完整閱讀 code review report
 
 完整閱讀 code review report，並深入閱讀相關受影響代碼，理解建議修復方案。
-如果外部環境允許使用 subagents，建議通過subagents完成對代碼的深度閱讀。
+如果外部環境允許使用 subagents，建議通過並行調度 subagents 完成對代碼的深度閱讀。
 
 ### 2. 修復發現的問題
 

package/update-project-html/SKILL.md

@@ -20,7 +20,7 @@ description: 當你發現項目架構圖過時，與實際代碼實作脫節，
 ### 2. 對照代碼庫及當前架構圖
 
 閱讀當前 repo，驗證當前架構圖是否存在錯誤、遺漏。
-如果外部環境允許使用 subagents，建議通過調度 subagents 完成代碼與架構圖的對照任務。
+如果外部環境允許使用 subagents，建議並行通過調度 subagents 完成代碼與架構圖的對照任務。
 
 ### 3. 通過 `apltk` cli 工具更新當前架構圖
 

package/version-release/SKILL.md

@@ -21,7 +21,7 @@ description: 當你需要協助用戶完成版本發佈時，使用這個技能
 ### 2. 更新項目文檔狀態
 
 完整閱讀上一次發佈版本至今的所有變更，並檢查文檔之中的表述是否存在錯誤或遺漏。如有，使用 `align-project-documents`, `maintain-project-constraints` 這兩個技能將所有項目文檔同步到最新狀態。
-如果外部環境允許使用 subagents，建議通過調度subagents完成變更的逐行深度閱讀。
+如果外部環境允許使用 subagents，建議通過並行調度 subagents 完成變更的逐行深度閱讀。
 
 ### 3. 發佈版本