@laitszkin/apollo-toolkit 3.14.1 → 3.14.3

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this repository are documented in this file.
 
+## [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
+
+- Support flags before verb in architecture atlas dispatch, preventing silent default to `open` when `--spec` precedes the verb (e.g., `apltk architecture --spec docs/plans/xxx feature add ...`).
+
 ## [v3.14.1] - 2026-05-15
 
 ### Fixed

package/align-project-documents/SKILL.md

@@ -21,7 +21,7 @@ description: 整理及維護項目文檔。當你需要管理項目說明文檔
 ### 2. 比對repo及項目文檔
 
 按照上一步建立的閱讀策略，全面搜索、查找整個repo，驗證並確保現有項目文檔的描述正確、無遺漏。
-如果外部環境存在subagents功能，建議調度subagents完成對repo的閱讀。
+如果外部環境存在 subagents 功能，建議通過並行調度 subagents 完成對repo的閱讀。
 
 ### 3. 制定文檔更新策略
 

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/init-project-html/SKILL.md

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

package/init-project-html/lib/atlas/cli.js

@@ -968,6 +968,26 @@ function splitList(value) {
   return String(value).split(',').map((s) => s.trim()).filter(Boolean);
 }
 
+function findFirstPositional(args) {
+  const booleanFlags = new Set(['no-render', 'no-open', 'help', 'force']);
+  let i = 0;
+  while (i < args.length) {
+    const token = args[i];
+    if (token === '--') return i + 1 < args.length ? i + 1 : -1;
+    if (token.startsWith('--')) {
+      const eq = token.indexOf('=');
+      if (eq !== -1) { i++; continue; }
+      const name = token.slice(2);
+      if (booleanFlags.has(name)) { i++; continue; }
+      if (i + 1 < args.length && !args[i + 1].startsWith('-')) { i += 2; } else { i++; }
+      continue;
+    }
+    if (token === '-h') { i++; continue; }
+    return i;
+  }
+  return -1;
+}
+
 function parseFlags(args) {
   const positional = [];
   const flags = Object.create(null);
@@ -1920,14 +1940,20 @@ async function dispatch(argv, io = { stdout: process.stdout, stderr: process.std
   const args = [...argv];
   let verb = 'open';
   let explicitVerb = false;
-  if (args.length > 0 && !args[0].startsWith('-')) {
-    verb = args.shift();
+  const verbIdx = findFirstPositional(args);
+  if (verbIdx >= 0) {
+    verb = args[verbIdx];
     explicitVerb = true;
+    args.splice(verbIdx, 1);
   }
   let subverb = null;
   const multiVerbs = new Set(['feature', 'submodule', 'function', 'variable', 'dataflow', 'error', 'edge', 'meta', 'actor']);
-  if (multiVerbs.has(verb) && args.length > 0 && !args[0].startsWith('-')) {
-    subverb = args.shift();
+  if (multiVerbs.has(verb)) {
+    const subverbIdx = findFirstPositional(args);
+    if (subverbIdx >= 0) {
+      subverb = args[subverbIdx];
+      args.splice(subverbIdx, 1);
+    }
   }
   const { flags } = parseFlags(args);
 

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.1",
+  "version": "3.14.3",
   "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. 發佈版本