From t-tools
Validates task plan executability and structural consistency with a 100-point scoring system and P0/P1/P2 fix list. Checks phase→slot→item hierarchy, schema conformance, DAG integrity, and manifest coverage across backend/frontend/miniapp/demo phases.
How this skill is triggered — by the user, by Claude, or both
Slash command
/t-tools:t-task-check [任务名称] [--phase <backend|frontend|miniapp|demo>][任务名称] [--phase <backend|frontend|miniapp|demo>]This skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
运行时边界统一参考:`${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md`
运行时边界统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md
phase -> slot -> item 结构。评分、阻塞条件、报告要求、跨轮收敛和 agent 评审边界统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md
证据优先级和争议处理统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md
/t-task-check [feature] [--phase <backend|frontend|miniapp|demo>]
| 参数 | 说明 |
|---|---|
[feature] | 功能名(必填) |
--phase <phase> | 指定阶段检查;未指定时检查 .state.json 当前阶段 |
.ai/design/[feature].mddocs/user-stories/**/*.md、docs/prd/**/*.md、.ai/tech-research/**/*.md(按设计文档引用读取).ai/task/[feature]/.state.json.ai/task/[feature]/[phase]/index.mddev.md、test.md、accept.mddev.md、accept.mddev/*.md、test/*.md、accept/*.mddev/*.md、accept/*.mdfinalize.md.state.json 的 schema 要求统一参考:
${CLAUDE_PLUGIN_ROOT}/protocols/task-state-contract.md${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md任一项缺失或非法即返回 TASK_SCHEMA_INVALID
.state.json 并验证 schema。--phase,仅检查该阶段;否则检查当前阶段。指定阶段必须存在于 .state.json.phases 的 active phases 中。index.md、slot manifest,并建立 item 文件清单。.state.json、slot manifest 和 item 文件头/关键字段抽取 id/title/agent/scope/expected_files/validation/depends_on/test_item_type/uses_skill/handoff_summary/completion_criteria。Grep、路径清单或 manifest 定位目标 item,再读取命中的 item 文件。${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md 校验 item DAG 与 manifest 覆盖关系。id/title/agent/scope/inputs/steps/expected_files/validation/depends_on/handoff_summary/completion_criteriatest_item_type: authoring|runneruses_skill: skills/t-backend-test-run/SKILL.mdExpected Test Manifest,逐项列出测试文件、测试函数/用例标题、来源 authoring item 和 runner 命令uv run scripts/check-test-runner-coverage.py [feature] --layer [layer] 做覆盖校验;backend 动态校验失败应记 P1 或 P0(取决于是否导致新增测试无法执行),frontend/miniapp/demo 静态校验失败至少记 P1uv run scripts/backend-test.py -- [filter];即使没有 filter,也必须写为 uv run scripts/backend-test.py --。不得写成 ${CLAUDE_PLUGIN_ROOT}/scripts/backend-test.py 或省略 --。需要串行执行时使用 uv run scripts/backend-test.py -- --test-threads 1 [filter] 并说明串行原因。若测试 item 使用 cargo run、裸 cargo test -- --test-threads=1、插件根路径或省略 -- 的后端测试命令,记 P1,并改为统一入口。Agent tool 调度当前阶段对应 subagent 做专业校验。每个 subagent 独立启动,传入 prompt 包含:该 agent/slot 相关 item 的文件路径、关键字段摘要、必要 item 全文或片段、设计文档相关节、验证范围、${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md 中的 agent 评审边界、输出格式要求(score/findings/fixes/summary)。可并行调度同阶段多个 subagent。
.ai/quality/task-check-[feature]-[YYYYMMDD-HHMMSS].md。调度方式:通过 Agent(subagent_type="<agent-name>") 启动。主流程收集所有 subagent 返回后进行交叉验证(证据优先级:仓库证据 > subagent 发现 > 假设)。
当前阶段 agent 输出字段和主流程补证要求统一参考:
${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.mdagent finding 不直接作为最终裁决;主流程必须按 rubric 完成证据复核和同类合并。
评分体系、P0/P1/P2 定义和报告结构统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md
| 错误码 | 触发条件 | 用户可见提示 | 恢复动作 |
|---|---|---|---|
DESIGN_DOC_MISSING | 设计文档不存在 | 未找到设计文档 | 先运行 /t-design [feature] |
STATE_FILE_MISSING | 任务目录或 .state.json 缺失 | 状态文件不存在 | 运行 /t-task [feature] --phase backend 重建 |
STATE_JSON_INVALID | .state.json 格式错误 | 状态文件解析失败 | 修复 JSON 后重试;或重建任务目录 |
TASK_SCHEMA_INVALID | 缺少 phase/phases/tasks/status/manifest/items 字段 | 任务状态结构不完整 | 运行 /t-task [feature] --phase [phase] 重建 |
PHASE_INVALID | --phase 不是 `backend | frontend | miniapp |
PHASE_NOT_ACTIVE | --phase 不在当前任务 active phases 中 | 当前项目未启用该阶段 | 使用 .state.json.phases 中存在的阶段,或重新运行 /t-task 生成该阶段 |
PHASE_DIR_MISSING | 阶段目录不存在 | 找不到阶段目录 | 运行 /t-task [feature] --phase [phase] 生成 |
ITEM_DAG_INVALID | item 依赖缺失或成环 | 子任务依赖非法 | 修复或重新生成该阶段 |
REPORT_INCONSISTENT | 报告中的严重度、总分、准入结论或问题数量互相冲突 | 报告自检失败 | 重新聚合证据并重生成报告 |
信息提示(不阻断):
PHASE_NOT_CURRENT:指定 --phase 非当前阶段时提示"当前阶段为 [state.phase],继续检查指定阶段"。PHASE_CHECK_AGENT_SET:展示本次实际调用的 phase agent 集合,便于复查。/t-task-check sample-feature --phase backend
输出:
总分: 92/100 (优秀,可进入实施)
状态文件验证: 通过
Item DAG 验证: 通过
状态文件结构: 15/15
文档完整性: 14/15
Item 可执行性: 18/20
内容一致性: 19/20
依赖与恢复: 15/15
文档规范: 8/10
代码示例质量: 3/5
Agent 集合: backend-dev, backend-test, backend-accept
问题分类摘要: confirmed=2, disputed=0, assumption=0
P1 问题:
- BE-D03 超过拆分阈值,建议拆为 repository trait 与 repository implementation 两个 item
下一步: /t-run sample-feature --phase backend
硬性门禁统一参考:${CLAUDE_PLUGIN_ROOT}/protocols/task-check-rubric.md
npx claudepluginhub timzaak/web-dev-skillsReviews task plans for executability, verifiability, dependency correctness, and spec coverage using INVEST validation, dependency graph checks, and traceability matrix. Blocks progression until approval step is complete.
Dispatches a reviewer subagent to validate plans structurally and for prose/design correctness before execution.
Evaluates implementation plans before execution using checklists for security, testing, architecture, error handling, and code quality. Provides structured feedback saved to work directory.