<img src="https://yellow-cdn.veclightyear.com/835a84d5/60958de0-f115-4218-972e-467d829a1b80.jpg" width="300"></img>

Clippinator

代码助手

(原名为Clippy)

Twitter帖子

入门指南

1. 安装Poetry。
2. 克隆此仓库。
3. 在.env文件中添加API密钥(OpenAI)：OPENAI_API_KEY=...。可选择添加SerpAPI密钥以允许模型使用搜索：SERPAPI_API_KEY=
4. 安装ctags。
5. 对于pylint，安装它和pylint-venv。
6. 安装依赖：poetry install。
7. 运行：poetry run clippinator --help。在项目上运行时，使用poetry run clippinator PROJECT_PATH
8. 你可以停止它，然后它会从上次保存的状态继续。使用^C向主代理提供反馈。

详情

Clippinator的目的是为用户或与用户一起开发代码。它可以自主规划、编写、调试和测试一些项目。对于更困难的任务，最佳使用方式是查看其工作并向其提供反馈。

该工具由几个代理组成，它们协同工作以帮助用户开发代码。这些代理基于GPT-4。请注意，这基于长时间运行的GPT-4，因此在OpenAI API方面相当昂贵。

事实是：它自身有一个合理的工作流程。它知道要做什么，并且能够做到。当它正常工作时，速度比人类快。然而，它并不完美，经常会犯错误。但与人类结合使用时，它非常强大。

显然，如果你要求它在非常低的抽象级别上做某事，比如"编写一个执行X的函数"，它会做到。它会自行提出这样的任务，成功程度不一。但与你结合使用时，它将能够完成一切，只需要你少量的干预。如果项目简单，你只需提供最高级别的指导（"编写一个链接缩短Web服务"），如果项目更复杂，你会更多地参与其中，但Clippinator仍将完成大部分工作。

Taskmaster

这个工具有一个名为_Taskmaster_的主要代理。它负责整体开发。它可以使用工具并将任务委派给子代理。为了能够长时间运行，历史记录会被总结。

Taskmaster调用专门的子代理（小兵），如_Architect_或_Writer_。

Taskmaster首先向用户提出一些问题以了解项目。然后它要求Architect规划项目结构，之后通过将任务委派给子代理来编写、调试和测试项目。

小兵

所有代理都可以访问计划的项目架构、当前项目结构、来自linter的错误和内存。代理使用不同的工具，如写入文件、使用bash（包括运行后台命令）、使用带有Selenium的浏览器等。

我们有以下代理：Architect、Writer、Frontender、Editor、QA、Devops。它们都有不同的提示和工具。

架构

架构只是由Architect编写的文本。它是一个文件列表，包含其内容的摘要，以注释形式呈现，以及重要行（如类和函数）。

架构对所有代理都可用。在初始阶段，实现架构是代理的目标。

工具

已实现（或从Langchain中获取）各种工具：

• 文件工具：WriteFile、ReadFile以及当前未使用的其他工具。
• 终端工具：RunBash、Python、BashBackground（允许启动和管理后台进程，如启动服务器）。
• 人工输入
• Pylint
• Selenium - 用于测试的浏览器自动化。它允许以便捷格式查看页面、获取控制台日志、点击、输入、执行selenium代码
• HttpGet、GetPage - 用于获取页面的更简单工具
• DeclareArchitecture、SetCI、Remember - 允许代理设置环境、编写架构、记住事情

项目结构、Linting、CI、内存

其中一个重要部分是项目结构，它提供给所有代理。这是一个文件列表，包含一些重要行，通过ctags获得。

Linter输出与项目结构一起提供。它有助于理解项目的当前问题。使用_WriteFile_后也会提供Linter输出。Architect可以使用_SetCI_工具配置linter命令。所有代理还可以使用_Remember_工具将一些信息添加到内存中。内存会提供给所有代理。

反馈

你可以按^C向主代理提供反馈。请注意，如果你在子代理执行期间按下它，子代理将被中止。这里唯一的例外是_Architect_：你可以在它使用DeclareArchitecture工具后按^C要求它进行更改。

在运行Architect后，如果你在提示中选择y，你还可以手动编辑项目架构。

如果你输入m或menu，你还可以编辑项目架构、目标和其他内容。

由Lev Chizhov和Timofey Fedoseev创建，Sergei Bogdanov贡献

Twitter帖子