用途:校验 TASKS(Task Breakdown)文档是否符合 Layer 11 schema 标准,可在用户请求校验 TASKS 文档时,或创建/修改 TASKS 产物后调用。
主要能力:
- 目录结构校验(阻塞项):所有 TASKS 文档必须位于嵌套目录,路径为 docs/11_TASKS/TASKS-NN_{slug}/TASKS-NN_{slug}.md,目录名与文件名须匹配 TASKS ID 模式,父路径须为 docs/11_TASKS/。
- 元数据校验:检查 document_type、artifact_type、layer、architecture_approaches、priority、development_status 等 custom_fields,以及 tasks、layer-11-artifact 等必需标签,并检测禁用标签模式。
- 结构校验:要求 12 个必需章节(文档控制、执行摘要、范围、实施计划、实施契约、约束、验收标准、风险评估、成功指标、可追溯性、实施说明、变更历史),可选第 13 章参考。
- 内容校验:任务使用 TASK-NNN 格式,阶段使用 Phase N: 格式,任务状态取值、实施契约类别(协议接口、异常层级、状态机、数据模型、依赖注入)等。
- 可追溯性校验:检查 8 个必需上游标签(@brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec)及可选标签,实施契约使用 @icon 标签。
- 实现就绪度评分:最低阈值 90%,由任务完整性、依赖映射、验收标准、实施契约、风险评估、工作量估算、可追溯性加权计算。
使用方式:运行 python ai_dev_flow/scripts/validate_tasks.py docs/11_TASKS/TASKS-001_example.md 校验单个文档;传入目录 docs/11_TASKS/ 校验全部;加 --verbose 输出详细信息。校验流程包括解析 YAML frontmatter、检查元数据、标签分类、章节结构、文档控制表、实施计划、任务格式、验收标准、实施契约、上游引用、计算评分、文件命名,最后生成报告。
适用场景:TASKS 文档创建或修改后的质量校验,以及跨文档 trace-check 的前置输入。
限制:资料未提供该技能的安装方式、收费模式、支持平台及运行环境要求;校验依赖 ai_dev_flow 目录下的 schema 与脚本,具体实现细节暂未提供。