Conductor 结构校验
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/conductor-validator。
技能介绍
要解决什么问题
团队用 Conductor 这类目录约定管理产品说明、技术栈、工作流和多条 Track 时,常见问题不是「有没有文档」,而是结构是否齐全、轨道目录是否对齐、清单里的状态标记是否一致。手工 ls 和肉眼扫 [ ] / [~] / [x] 既慢,也容易漏掉某个必需文件或命名不规范的 track。
技能如何工作
本技能把校验流程写成可执行的检查步骤,核心包括:
- 确认项目根下是否存在
conductor/目录 - 列出
conductor/tracks/下全部轨道目录 - 核对
conductor/index.md、product.md、tech-stack.md、workflow.md、tracks.md是否齐备 - 在文档中识别轨道与任务的三种状态:
[ ]未开始、[~]进行中、[x]已完成 - 参照类似
feature_user_auth_20250115的命名示例,理解 track 目录与清单条目的对应关系
Agent 按上述清单逐项执行时,相当于对 Conductor 布局做一次结构化巡检,而不是泛泛地「读一遍 README」。
适用边界与注意点
- 技能描述的是目录与文件存在性、清单语法层面的校验,不会替代你对业务内容正确性的评审。
- 状态标记依赖 Markdown 里约定的方括号写法;若团队改用其它格式,需要自行扩展检查规则。
- Track 命名示例仅作约定参考,是否强制日期后缀取决于你们自己的 Conductor 规范。
使用场景
- 新功能开 track 前,先确认仓库里已有 `conductor/` 且五份核心 md 文件齐全
- 合并分支前对照 `conductor/tracks/` 目录是否与 `tracks.md` 里列出的轨道一致
- 迭代复盘时批量扫文档里 `[ ]`/`[~]`/`[x]`,汇总各 track 与任务的进行与完成情况
- 按 `feature_user_auth_20250115` 一类命名新建轨道目录后,核对目录与清单条目是否对应
适合人员
- 在多个仓库推行 Conductor 约定、需要统一核对目录与必需文件的技术负责人
- 负责按日期后缀命名 feature track、维护 `conductor/tracks/` 与清单同步的功能开发工程师
- 维护 `product.md`、`workflow.md` 与 `tracks.md` 一致性的产品或文档 Owner
- 发版或门禁前要对 Conductor 布局做结构化巡检而非人工逐文件打开的发布协调同学