pm-tasks-core 是做什麼的?
所有 pm-tasks-<工具> 轉接器的共享核心。定義了提取階段、通用卡片結構、CRUD 詞彙、自主模式合約、配置查找規則和審計日誌格式。轉接器通過路徑引用此技能 — 規格中沒有正式的依賴機制。
路由
轉接器在應用其特定於工具的格式化之前調用此技能。具體指針在 references/contract.md 中記錄。
階段
| 階段 | 目的 | 參考文檔 |
|---|---|---|
| 1 | 識別輸入(計畫檔案 vs 內聯貼上 vs 隱含) | references/contract.md § 1 |
| 2 | 按意圖提取區塊(目標、先決條件、任務、完成條件) | references/contract.md § 2 |
| 2.5 | 反模式檢查 | anti-patterns/core.md |
| 3 | 構建通用卡片 | references/generic-card.md |
然後轉接器根據其自身的 SKILL.md 執行階段 4 及後續階段。
CRUD 詞彙(轉接器實現的動詞)
請參閱 references/crud-vocabulary.md。六個動詞,全部冪等(對於非自然情況使用 clientToken 規則)。
自主模式
請參閱 references/autonomous-mode.md。僅由哨兵 [autonomous] / --auto / 環境變數 LLODEV_PM_TASKS_AUTONOMOUS=1 啟用。需要工具的配置中具有明確的允許清單、範圍和速率限制。絕不隱含推斷。
配置
查找順序:<git-root>/.<工具>.json → ~/.config/llodev/pm-tasks/<工具>.json → 中止。秘密絕不在 JSON 中(僅使用環境變數 / 作業系統鑰匙圈)。
審計日誌
僅附加的 JSONL,位於 ~/.local/share/llodev/pm-tasks/<工具>/audit.log。模式見 references/audit-log-format.md。同時用作 <task-ref> 解析的查找索引。
初始化輔助工具
轉接器暴露 npx @llodev/pm-tasks-<工具> init。共享使用者體驗見 references/init-ux.md。實現庫位於 @llodev/pm-tasks-core/init-lib(TypeScript 原始碼位於 ./src/init-lib.ts;編譯至 ./dist/init-lib.js)。
健康檢查(醫生)
pm-tasks-core-doctor 驗證工作區配置、自主模式允許清單、審計日誌可寫性和網路通達性。檢查矩陣和退出碼見 references/doctor.md — pm-tasks-core-doctor 檢查目錄及退出碼。
獨立備用方案
此技能在沒有轉接器的情況下無用。如果單獨啟用,請告知使用者安裝至少一個 pm-tasks-<工具> 軟體包。