YYLO

什么是 YYLO？

YYLO（发音为 why-lo）是一个开源的作业系统与智能体工程平台，旨在协调由 AI 驱动的编码智能体。它引导工程项目从初始意图开始，直至交付经过验证、可用于生产的代码。至关重要的是，YYLO 保留了完整的“工程记忆”——记录了任务定义、会话详情、代码评审以及评估证据，这些内容精确解释了变更是如何以及为何发生的。这确保了团队不仅能运行自动化工作，还能完全理解每一段生成代码背后的决策过程和结果。

YYLO 的主要特性

从意图到代码的完整可追溯性：YYLO 捕获工程任务的完整生命周期。从任务创建、智能体委派到验证、评审和合并的每一个操作都被记录并关联起来，形成可审计的工作轨迹。

保存工程记忆：与孤立的自动化脚本不同，YYLO 维护持久证据。这包括原始任务意图、约束条件、智能体工作树、模型来源、测试结果、评审意见以及最终的提交产物，使得代码变更背后的“原因”永久可查。

协调多智能体工作流：该平台充当控制平面，将限定范围的工作片段路由到专门的 AI 智能体（如集成的 pi 子智能体）和模型。它管理依赖关系并在隔离环境中执行工作，以确保结果干净且可复现。

与现有 Git 工作流集成：YYLO 不会取代你的版本控制系统。它通过在你的 Git 仓库中直接添加结构化任务管理和证据记录来增强现有流程，使智能体工作成为你工程流程中一等且可追溯的部分。

支持验证与评审：内置的测试、策略约束的评审和证据收据机制确保智能体生成的代码在集成前符合质量标准。团队可以基于具体、保留的证据，自信地接受或拒绝提议的变更。

如何使用 YYLO？

使用 YYLO 涉及安装其命令行界面并将其集成到你的开发工作流中，以管理智能体任务。

1. 安装：首先通过 npm 全局安装 YYLO CLI。

   npm install -g @yylo/[email protected]
   

2. 初始化任务：定义一个明确的工程产出。例如，要使用 pi 智能体为项目添加键盘导航，你可以运行：

   yy init --task "Add keyboard navigation" --subagent pi
   

   这会在你的 Git 仓库中创建一个包含明确意图和约束的任务记录。

3. 委派与执行：启动协调工作。YYLO 会将任务路由到指定的智能体，该智能体将在隔离的工作树中运行。你可以监控和管理执行过程：

   yy start -s pi -i 1
   

4. 验证与评审：一旦智能体提出代码，YYLO 会帮助你通过测试和结构化评审流程进行验证。此阶段的证据——测试、评审意见、收据——将与任务一同保存。

5. 记录与合并：被接受的变更会连同其完整来源信息一并提交。所有产物——任务响应、提交记录和评审证据——都会被记录到 Git 内的 YYLO Ledger 中，为未来的参考和学习创建一份关于“发生了什么”的持久记录。

价格与许可

YYLO 是一个完全 ### 开源的平台。核心软件，包括 YYLO 控制平面、Ledger 和 Benchmark 组件，均在开源许可下免费提供。你可以安装、使用和修改它，无需任何订阅费用。该项目托管在 GitHub 上，欢迎贡献。没有供应商锁定；你对自己的工程记忆和工作流拥有完全控制权。

最大化利用 YYLO 的实用技巧

• 从小处着手：从一个可验证的单一变更开始，以理解工作流程。使用示例命令 yy init --task "Ship one verified change" --subagent pi 来熟悉流程。

• 善用 Ledger：将 YYLO Ledger 视为你智能体工作的唯一事实来源。它将你的 Git 仓库转变为一个可查询的工程意图与成果数据库。

• 定义清晰、范围明确的任务：系统在任务范围明确时效果最佳。清晰的意图和约束能更有效地指导智能体，并产生更聚焦、可评审的结果。

• 使用 Benchmark 进行评估：随着规模扩大，使用 YYLO Benchmark 组件来创建不可变的测试用例，比较不同智能体的尝试，并积累评估证据以指导未来的智能体选择和调优。

• 检查证据：始终审查保存的会话来源、工作树和验证收据。这种“工程记忆”是调试、改进流程以及在自动化工作流中建立信任的关键。

常见问题解答 (FAQs)

YYLO 解决了什么问题？

YYLO 解决了 AI 驱动编码中的“黑盒”问题。虽然智能体可以生成代码，但它们通常缺乏透明度。YYLO 确保从初始任务请求到最终合并代码的每一步都被记录、验证和保存，使得智能体工程可审计且值得信赖。

YYLO 会取代 Git 或 CI/CD 工具吗？

不会。YYLO 是一个与你现有工具 协同 工作的协调层。它使用 Git 作为任务事实（Ledger）的持久存储，并集成了可补充你 CI/CD 流程的验证步骤。它协调产生代码的工作，然后通过你标准的 Git 工作流来管理这些代码。

我可以在 YYLO 中使用自己的 AI 模型或智能体吗？

可以。架构设计为可扩展。虽然它附带了像 pi 这样的集成子智能体，但该平台旨在将工作委派给不同的智能体和 AI 模型，允许你根据需要接入专门的工具。

什么是“工程变更”，它是如何保存的？

“工程变更”是 YYLO 的战略记录，它将高层意图、执行决策、智能体尝试、已验证的代码和结果联系起来。它保存在系统的三个层面：YYLO 控制平面协调行动，Ledger 在 Git 中存储任务事实，Benchmark 保留评估证据，三者共同构成一个相互关联的记忆。

我的代码或数据会被用于训练吗？

作为一个由你托管和控制的开源平台，YYLO 不会将你的代码、任务数据或工程记忆发送到外部服务器用于训练目的。你的证据和工作流数据始终保留在你自己的版本控制仓库和基础设施内。