pm-tasks-core 是做什么的?
所有 pm-tasks-<tool> 适配器的共享核心。定义了提取阶段、通用卡片结构、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>/.<tool>.json → ~/.config/llodev/pm-tasks/<tool>.json → 中止。秘密信息绝不放在 JSON 中(仅使用环境变量或操作系统密钥链)。
审计日志
追加写入的 JSONL 文件,位于 ~/.local/share/llodev/pm-tasks/<tool>/audit.log。模式见 references/audit-log-format.md。同时作为 <task-ref> 解析的查找索引。
初始化辅助工具
适配器暴露 npx @llodev/pm-tasks-<tool> init。共享用户体验见 references/init-ux.md。实现库位于 @llodev/pm-tasks-core/init-lib(TypeScript 源码在 ./src/init-lib.ts;编译至 ./dist/init-lib.js)。
健康检查(doctor)
pm-tasks-core-doctor 验证工作区配置、自主模式白名单、审计日志可写性以及网络可达性。检查矩阵和退出码见 references/doctor.md —— pm-tasks-core-doctor 的检查目录和退出码。
独立回退
此技能没有适配器则无法使用。如果单独激活,请告知用户至少安装一个 pm-tasks-<tool> 包。