conductor-validator

Conductor Validator - Conductor 项目验证工具

技能概述

Conductor Validator 是一个用于验证 Conductor 项目工件的完整性、一致性和正确性的自动化检查工具，适用于项目设置后、问题诊断时或实施前的项目上下文验证。

适用场景

1. 项目设置后验证

在完成 Conductor 项目初始设置后，使用本工具验证目录结构、必需文件和配置是否符合规范，确保项目基础环境正确。

2. 问题诊断

当 Conductor 项目出现异常或预期行为不符时，运行验证器快速识别配置错误、文件缺失或格式不一致等问题。

3. 实施前验证

在开始实施新功能或修改前，验证项目上下文的完整性，避免在不完整或配置错误的基础上进行开发。

核心功能

1. 目录结构验证

自动检查 Conductor 目录是否存在，验证 tracks/ 子目录及核心文件（index.md、product.md、tech-stack.md、workflow.md、tracks.md）的完整性。

2. 模式匹配检查

解析并验证 tracks.md 中的状态标记（未开始 [ ]、进行中 [~]、完成 [x]）和 plan.md 中的任务标记，确保格式符合约定。

3. Track ID 规范验证

检查 Track ID 是否符合 <type>_<name>_<YYYYMMDD> 格式规范，例如 feature_user_auth_20250115，帮助维护统一的命名约定。

常见问题

conductor-validator 什么时候应该运行？

建议在三个关键时机运行：完成项目初始设置后、遇到问题需要诊断时、以及开始实施新功能前。这能确保项目始终处于健康状态。

验证器会检查哪些具体内容？

验证器会检查 Conductor 目录是否存在、tracks 子目录是否完整、核心文件（index.md、product.md、tech-stack.md、workflow.md、tracks.md）是否齐全，以及状态标记和 Track ID 格式是否正确。

如果验证失败该怎么办？

验证失败时会指出具体的问题位置和类型。根据报告检查缺失的文件或目录，修正不符合规范的状态标记或 Track ID 格式，然后重新运行验证直到通过。

tracks.md 中的状态标记代表什么？

[ ] 表示轨道/任务未开始，[~] 表示正在进行中，[x] 表示已完成。这些标记帮助团队快速了解项目进度状态。