Skip to content

校验与任务区(check / task) ​

软告警开关、勾选框与词标记扫描,以及任务目录与导入列映射。

check:校验与告警 ​

字段类型默认说明
warningsbooleantrue软告警总开关(task check 的 warn 输出、归档/发版提醒、changelog 无类型前缀条目告警);被 --warn/--no-warn 与 FX_TOOLKIT_CHECK_WARN 覆盖
includeCheckboxbooleantruetask check 是否把正文未勾选的 - [ ] 扫为未闭合待办
pendingMarkersbooleantruetask check 是否扫描词标记(待办/待实施/…);只认正文行首子项形态,跳过标题、代码块与引用块

task check 另校验 scope 取值是否在 .tasks/conventions/index.md 的端清单内(common 恒合法),载体缺失或端清单为空表时跳过;只校验 active 任务,不回溯归档。

task:任务目录与导入列映射 ​

字段类型默认说明
dirstring".tasks"任务目录;支持绝对路径或 ../ 相对路径,任务区可放项目外(如独立文档仓库);被 CLI --dir 覆盖,init、tasks 与 conventions 同口径。旧段名 tasks 仍可读取,toolkit init 自动重写
importColumnsobject无键 = 实际表头列名(匹配不区分大小写),值 = 标准字段名(title/status/owner/scope/created/updated/completed/depends/body);优先级高于内置别名表
json
{
  "task": {
    "dir": "../my-tasks-repo",
    "importColumns": { "我的标题": "title", "Deadline": "completed" }
  }
}

相关页面 ​

MIT 开源协议