Community研究與資料分析github.com

pm-tasks-core

所有 `pm-tasks-<工具>` 轉接器的共享核心。定義了提取階段、通用卡片結構、CRUD 詞彙、自主模式合約、配置查找規則和審計日誌格式。

pm-tasks-core 是什麼?

`pm-tasks-core` 是一個共享核心技能,為所有 `pm-tasks-<工具>` 轉接器提供基礎定義。它明確定義了從輸入(計畫檔案、內聯貼上或隱含)中提取區塊的階段(共三個階段,加上一個反模式檢查階段),以及構建通用卡片的結構。此外,它還定義了六個冪等 CRUD 動詞、自主模式的觸發條件(必須由明確的哨兵啟用,絕不隱含推斷)、配置的查找層級順序(從專案本地到使用者全域),以及一個僅附加的 JSONL 審計日誌。此技能主要支援 Claude Code、Cursor、Codex、Windsurf 等遵循開放 Skills 規範的代理平台。轉接器通過路徑引用此技能,並在其自身的 SKILL.md 中會在調用此技能後執行特定於工具的格式化(階段 4+)。它還提供初始化輔助工具 (`npx @llodev/pm-tasks-<工具> init`) 和健康檢查工具 (`pm-tasks-core-doctor`)。如果沒有轉接器,此技能無法單獨使用。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Windsurf
npx skills add llodev/skills

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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-<工具> 軟體包。

相關技能