SuperAPI AI 工具集

run-codeplain

通用与其它

查看项目

更新于 10-16 03:43

技能介绍

用途:run-codeplain 是围绕 codeplain CLI 实时渲染的监督技能,本身不生成代码,只负责启动渲染、跟踪进展、用通俗语言向用户汇报,并在出现异常时(经用户同意)停止渲染、转交合适的编辑技能,再从最后完成的功能点恢复。

主要能力:启动 codeplain <module>.plain 或接入已在运行的渲染;按优先级监视三类信号——codeplain.log(首要,记录渲染器的动作、决策、重试与失败)、plain_modules/<module>/ 与 conformance_tests/<module>/ 下的生成产物(次要,用于印证或反驳日志)、进程/TUI 状态(第三,仅用于判断是否继续监视)。日志与文件系统不一致时以日志为准。

使用方式:先做预检——确认目标 .plain 文件、在最近一次规格编辑后运行 plain-healthcheck(失败则停止)、确认 codeplain 在 PATH、CODEPLAIN_API_KEY 已导出或改用 --api-key、确认对应 config.yaml 存在;与用户商定参数,默认使用最小命令行,仅在适用时提及 --config-name、--render-range/--render-from、--force-render、--template-dir、--copy-build/--build-dest、--copy-conformance-tests/--conformance-tests-dest、--test-script-timeout、--api-key/--api、--render-machine-graph、--headless。启动必须使用 --headless 后台方式:nohup codeplain <module>.plain --headless <other-flags> > /dev/null 2>&1 &,记录 PID,并确认 codeplain.log 开始增长。监视时按字节偏移增量读取日志,维护 CURRENT_FUNCTIONALITY、LAST_COMPLETED_FUNCTIONALITY、ATTEMPT_COUNTER 三个状态,识别日志中的功能开始、单元测试、一致性测试重试、规格过复杂、规格图错误、规格冲突、Python 堆栈、渲染失败/成功、API 限流等模式。

适用场景:用户要求“render it”“运行 codeplain”“渲染 <module>.plain”,或已在其他终端运行渲染需要代为看护,或 forge-plain/add-feature/debug-specs/plain-healthcheck 完成后进入正式渲染。

限制:不用于 dry-run 门禁(用 plain-healthcheck),不用于编写或编辑规格(用 forge-plain、add-feature、debug-specs 及相应 add-/resolve-/break-down-* 技能)。该技能基本只读,不修改 .plain 文件,只写控制文件(可能终止进程并再次调用 codeplain 恢复)。TUI 模式与代理启动不兼容,必须使用 --headless。资料未提供收费、价格与平台支持信息。