如何使用 Conductor 校验项目资产的完整性与一致性

解决项目初始化后文档缺失或不一致的问题：通过一套标准化的检查清单，验证 Conductor 项目的目录结构、核心文件及进度标记是否正确，确保 AI 和团队在同一上下文环境下工作。

为什么需要这个技能

在复杂的项目实施过程中，如果基础的上下文定义（如产品需求、技术栈、工作流）缺失或版本不一致，AI 生成的代码或方案往往会偏离预期。

Conductor 机制通过一套结构化的文档来定义项目，但随着项目演进，文件可能会被遗漏或状态标记更新不及时。本技能提供了一套自动化的校验逻辑，让 AI 在开始具体实现前，先检查“地基”是否稳固，避免在错误的前提下浪费开发资源。

适用场景

• 项目启动阶段：在 setup 之后，验证所有必需的引导文档是否已创建。
• 故障诊断时：当 AI 表现出对项目背景理解偏差时，用于检查上下文资产是否完整。
• 实施前验证：在进入具体 Feature 开发前，确认相关 Track 的状态和依赖关系。

核心工作流

1. 结构完整性检查：验证 conductor/ 目录及其子目录 tracks/ 是否存在。
2. 核心文件核对：检查以下关键文件是否就绪：
   • index.md（索引）
   • product.md（产品定义）
   • tech-stack.md（技术栈）
   • workflow.md（工作流）
   • tracks.md（进度追踪）
3. 模式匹配校验：
   • 状态标记：检查 tracks.md 和 plan.md 是否使用标准标记（[ ] 未开始, [~] 进行中, [x] 已完成）。
   • ID 规范：验证 Track ID 是否符合 <type>_<name>_<YYYYMMDD> 格式（例如 feature_user_auth_20250115）。

# 检查 conductor 目录是否存在
ls -la conductor/

# 查找所有 track 目录
ls -la conductor/tracks/

# 检查必需文件
ls conductor/index.md conductor/product.md conductor/tech-stack.md conductor/workflow.md conductor/tracks.md

下载和安装

下载 conductor-validator 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐