用途:把 .plain 规格(spec)渲染为可运行且经过测试的代码实现。适用于被要求渲染、构建或实现某个 .plain 规格文件或模块时。
主要流程:
- 环境检查:需要 Python 3.8 或更新版本,依次尝试 python3、py、python 运行 scripts/check_version.py check,取第一个输出含 current: 行的解释器;无则中止并报告缺失依赖。
- 读取规范语言:加载 <skill_folder>/references/plain-lang.md。
- 生成 RenderPlan:读取目标模块及所依赖模块的 frontmatter,检查依赖图无环,按依赖顺序生成计划并写入 ./.pyro/render-plan.md。
- 依赖核验:用 scripts/plain_sections.py 提取 impl-reqs 与 test-reqs,写入 .pyro/dependencies.md,缺失依赖时不得安装,直接中止并报告。
- 逐模块渲染:对每个模块提取规格与需求,编写测试场景到 .pyro/<module>/scenarios.md,实现代码到 plain_module/code,测试到 plain_module/tests,运行单元测试与一致性测试,并逐条核对需求。
- 收尾:清理 plain_module/code 中的依赖产物(如 node_modules/、.venv/、pycache/),保留清单与锁文件;用 scripts/copy_folder.py 复制到 dist;给出运行测试与渲染结果的命令并报告版本。
关键约束:所有步骤须自行完成,不得交给子代理或工作流;不得改动 plain_module 与 .pyro 之外的文件;不得安装缺失依赖;需求须逐字保留,不得改写或删减。
使用命令示例(保持原样):<python> "<skill_folder>/scripts/plain_sections.py" [--include-filename] [--output <path>] <section> <spec.plain> [...],其中 <section> 为 defs、impl-reqs、test-reqs、func-specs、acc-tests 或 all。
限制:该技能依赖上述脚本与参考文件,官方文档未提供的信息暂未提供;不保证对任意目录或未安装 Python 的环境可用。