用途:当仓库难以运行、测试、调试或让新人上手,贡献者之间的本地环境差异过大,或内环(inner loop)缓慢且缺乏文档时,使用本技能改善开发者体验。它聚焦本地开发流程,不用于生产部署、流水线策略,以及与开发工作流无关的纯文档清理。
主要能力:产出具体的项目增量,包括代码、文档、配置、测试、CI 或评审产物;通过显式规划、验证和最终校验减少不确定性;留下可复用的项目上下文,让后续任务更快更安全。目标是降低本地工作流摩擦、改善上手体验、建立可复现的构建、运行、测试和调试路径。
使用方式:先阅读最近的 AGENTS.md 确认范围与约束,再通过 Ralph Loop 执行本技能的工作流,最后按 Required Result Format 返回具体产物与验证证据。工作流先定位内环中最慢或最脆弱的一环(克隆与安装、构建、运行与调试、测试),在优化前先标准化任务,优先提供一种有文档的完整本地运行方式,并只加载与当前本地开发问题匹配的参考。Ralph Loop 要求先头脑风暴(分析现状、定义问题与目标、约束与风险、生成方案与权衡),再制定执行计划(列出最终要运行的校验技能及顺序与理由),然后每轮执行一步并产出具体增量,评审结果、分批修复、重跑检查、更新计划,直到结果可接受或只剩显式例外。若缺少依赖,则引导安装,或返回 status: not_applicable 并说明原因与回退路径。
结果格式:status(complete | clean | improved | configured | not_applicable | blocked)、plan、actions_taken、validation_skills、verification、remaining。仅为安装类请求且不执行时,返回 status: configured 与确切的后续命令。
校验要点:新人能按文档完成而不依赖隐藏的安装知识;内环明确且可复现;跨平台或容器化指导只在确有帮助时使用;本地开发使用真实服务、容器或沙箱环境,而非假实现或桩。
限制:不用于生产部署或流水线策略,也不适用于不影响开发者工作流的纯文档整理。