marathon-ralph

根据规格文件自动构建完整应用程序的AI代理

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:marathon-ralph。
它的用途是:根据规格文件自动构建完整应用程序的AI代理
完整的 Skill 内容见:https://321skill.com/skills/marathon-ralph/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'/marathon-ralph:run product_spec.md',它会读取你的产品规格文件,自动在Linear中创建项目并拆解出所有开发任务,然后开始自主编码、编写测试并推进项目,直到所有功能完成并测试通过。你可以随时使用'/marathon-ralph:status'查看当前进度。

介绍

Marathon Ralph 是一个Claude Code插件,旨在解决从零开始构建应用程序时面临的繁琐任务管理和质量控制问题。开发者只需提供一个详细的规格文件,它便能自动将项目拆解为开发任务,并逐一完成编码、测试和验证,直至交付一个功能完整、测试覆盖的应用。

使用方式非常直接:安装插件并配置好Linear MCP服务后,通过一条命令启动马拉松。插件会读取你的规格文件,在Linear中创建对应的项目与任务清单,然后自主地按照“验证-规划-编码-测试-质量保证”的循环处理每个任务,全程无需人工干预。你可以随时查看进度或安全地暂停。

这个技能特别适合全栈开发、项目经理或产品经理,他们希望快速将产品概念或详细需求转化为可工作的原型或最小可行产品,从而专注于更高层次的设计和业务逻辑,而非陷入具体的编码和测试循环中。

建议在使用前,花时间编写一份结构清晰、技术栈明确的XML规格文件。同时,请确保已正确配置并授权Linear MCP服务,因为它是插件进行任务管理和状态持久化的核心依赖。对于高度探索性、需求极不明确或严重依赖创意设计的项目,可能仍需结合人工迭代。

核心特点

与仅生成代码片段的工具不同,Marathon Ralph 接管了从需求拆解、任务管理到编码、测试、回归验证的完整软件开发生命周期,并通过与Linear集成实现了跨会话的持久化工作流,确保项目能持续推进直至完成。

注意事项

不适合需求极度模糊、需要频繁人工创意介入或严重依赖实时交互反馈的探索性项目开发。

常见问题

Marathon Ralph 需要联网吗?

需要,它依赖Linear MCP服务进行任务管理和状态同步。

它能构建什么类型的应用?

主要适用于Web全栈应用(如示例中的Next.js + 后端API),具体能力取决于规格文件中定义的技术栈。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/marathon-ralph/raw/index.md 读取 marathon-ralph 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。