用途:这是一个工作流类技能,用于在项目中触发 Seed Test Data 流程,目标是生成幂等的 QC 正常路径(happy-path)测试种子数据。
主要能力:按固定步骤执行——$scout 查找功能区域命令文件并定位同服务内已有 seeder 作为模式参考;$investigate 读取 seeder 将调用的命令,梳理必需输入、校验规则、副作用与跨服务依赖;$seed-test-data 实现或增强 seeder;$changes-review 做合规审查;$code-simplifier 在不改变行为的前提下简化;$docs-update 评估文档影响;$workflow-end 与 $watzup 收尾并总结。
使用方式:在 Codex 中用 $skill-name 形式调用仓库技能,并以 $start-workflow workflow-seed-test-data 携带用户提示作为上下文启动。步骤顺序为 $scout → $investigate → $seed-test-data → $changes-review → $code-simplifier → $docs-update → $workflow-end → $watzup,不得跳过、重排或合并,除非用户事先明确同意偏离。
关键约束:写任何 seeder 代码前,必须先读 docs/project-config.json 的 'Data Seeders' 上下文组以及 docs/project-reference/seed-test-data-reference.md;必须先用环境门控,再检查现有数量,循环从 existing_count 到 target_count(绝不从 0 开始,以保证可重启安全);领域实体不得直接调用仓储或数据库,只能走应用层命令;每次迭代使用项目自身的 scoped DI 机制,不得跨迭代共享 DI 作用域。所有结论需有 file:line 证据且置信度高于 80% 才可行动。
适用场景:需要为 QC 正常路径准备可重复执行、幂等的测试数据时。
限制:资料未提供具体项目结构、命令签名或配置键值示例;若某必需步骤或工具在当前环境无法运行,应停止并询问用户,而非自行适配。