QualityLayer：AI 编程工作流平台

项目简介

QualityLayer 是一个围绕 AI 编程代理搭建的软件开发工作流平台。它把一次改动的设计决策和验证过程变得可见：先用可视化方式规划，再让代理实现并验证。你可以在内置 App 或浏览器里与代理并肩工作，也可以继续使用自己常用的终端或 IDE。

代理运行在你已有的订阅或 API Key 上，支持 Claude Code、Codex、Cursor、Grok、Antigravity、Pi、OpenCode 等。

主要功能

• 七步工作流：Discuss、Research、Plan、Outline、Implement、Verify、Review，最后到 Pull request。你在 Plan 和 Review 两处审批，合并由你决定。
• 可视化规划：用图表、可点击页面和检查项表达设计，直接在图上评论，批准后代理才开始改代码。
• 测试先行：负责实现的代理先写测试，再修到通过；必要时把独立的小切片分派出去。
• 检查与独立审查：运行项目自带的测试、类型检查、linter、代码健康检查和安全扫描，并由另一个代理对照你的需求审查改动；无法验证的部分会在 Review 中保留。
• Artifacts：在写代码前试玩 mockup、架构图和可点击页面，把反馈钉在任意位置，代理据此更新。
• 自定义要求：可以为任意步骤添加自己的检查、工具和技能，Review 会显示哪些执行了、哪些被跳过。
• 记忆与协作：复用关于项目和你的工作方式的 lessons，也可以通过 Slack 或邮件邀请队友、共享任务。
• App 内控制：查看代理对话或终端、阅读文件 diff 并逐行评论、选择模型与权限、跟踪用量。

安装与使用

前置条件：已安装并登录的编程代理、你自己的订阅（Claude 或 ChatGPT 计划，或 API Key）、Git 和一个仓库。

从官网下载 App 并打开，初始化会自动安装 qualitylayer 命令并连接代理。在服务器、WSL 或容器中可改用命令行：

curl -fsSL https://qualitylayer.dev/install.sh | bash      # macOS, Linux, WSL
irm https://qualitylayer.dev/install.ps1 | iex             # Windows PowerShell

App 会自动更新；没有 App 时运行 qualitylayer update。

首次使用时，在 App 或浏览器中选择 + New，再选 Chat、Feature 或 Bugfix，指定仓库和代理并描述需求。Feature / Bugfix 可选择 Plan with QualityLayer，或粘贴已有计划。之后依次回答问题、批准 Plan、等待代理构建与验证，最后在 Review 中批准结果。

初始化会安装六个技能，用自然语言点名 QualityLayer 或 QL 即可调用：ql-workflow（规划、构建、验证、审查）、ql-artifact、ql-manage、ql-peer、ql-quality、ql-chat。只有 ql-workflow 会启动规划与构建工作流。

卸载可运行 qualitylayer uninstall，计划文件会保留。

注意事项

• QualityLayer 只在你明确提出请求时才运行。
• 任务文件保存在你自己的电脑上，共享任务在分享前会先加密；编程代理使用其自身的服务商。
• 工作流可在 Settings 中切换 Engineering（从技术方案开始）和 Product（从产品简报开始）两种层级。
• 需要更换代理或环境时，先停止当前运行，再说“Using QL, continue task <任务名>”。

本作品整理自 GitHub 开源项目 maxritter/qualitylayer，原作者 @maxritter。中文介绍由 AI 根据项目 README 整理，以原仓库为准。