皮巴语

Pipa是一个管弦乐和 执行纪律的一揽子计划 Pi 编码代理。 。 。 .

将Pi扩展为结构化的任务执行,分散的队友,持续 项目规划、知识管理、许可警卫和背景卫生.

安装

从 npm

pi install npm:@aelinrezende/pipa

锁定特定版本 :

pi install npm:@aelinrezende/[email protected]

来自 GitHub

pi install git:github.com/aelinrezende/pipa

项目安装

使用 --local 将 Pipa 注册在当前项目中 .pi/settings.json数字 :

pi install --local npm:@aelinrezende/pipa

何为 Pipa 添加

• 设置任意域的 Pipa 交互式登入 .
• 特定领域 plan, (中文(简体) ), execute,以及 finish 为项目创造的技能.
• 分散,坚持队友直接合作.
• 结构化的任务包括所有权、依赖性、班级和生命周期执行.
• 小执行步骤的会话级待办事宜列表 .
• 持续积压的史诗、故事、任务和错误修正项目.
• 一个有Markdown文件和模糊搜索的项目知识库.
• 授权守护终端命令和直接文件修改.
• 自动清理吵闹的模型上下文 .
• 英语和巴西葡萄牙语接口消息.

登入和配置

皮帕不以预先确定的专业重点为航线. 何时 .pi/PROFILE.md 不存在, 它开始一个互动的登入过程 来学习哪种 环境将支持、代理人应如何沟通、 它们必须尊重制约因素,以及应如何评价质量.

Pipa使用单一语言中性登机提示. 它首先试图推断 用户初始消息中的谈话语言。 如果信息也一样 pipa问道: 用户在继续前喜欢哪种语言。 在发现的时候,它也 确定生成的物剂和文物的工作语文;这可能有所不同 从第一个消息语言和配置的 UI 语言.

预先定义的答案只是发现辅助. 免费答复和后续 问题允许Pipa配置任何专门或混合的工作流程.

示例简介

上载创建项目的操作系统:

• .pi/PROFILE.md: 共同目的,领域,语言,词汇,全球规则,约束,以及文物公约.
• .pi/skills/plan/SKILL.md:工作如何理解,调查,分解,风险评估,审批.
• .pi/skills/execute/SKILL.md:核定工作是如何下放、执行、验证和记录的.
• .pi/skills/finish/SKILL.md:如何审查、报告、保存和关闭或移交结果.
• .pi/teammates/*.md: 初步专家角色由简介提出并获得用户批准.

flowchart LR
    Start[First message] --> Language{Language clear?}
    Language -->|Yes| Discovery[Discover domain, working language, constraints]
    Language -->|No| Ask[Ask preferred language]
    Ask --> Discovery
    Discovery --> Profile[Create PROFILE.md]
    Profile --> Skills[Generate plan, execute, finish]
    Skills --> Roles[Propose specialist roles]
    Roles --> Team[Create approved teammates]
    Team --> Restart[Restart Pi]
    Restart --> Ready[Domain-configured Pipa]

plan, (中文(简体) ), execute,以及 finish 是为选定的域生成的;它们是 不是通用软件开发指令。 简介、技能和队友 定义是正则的Markdown文件,可以随环境而演化.

队友默认使用不偏重地方,基于角色的标识符. 如果人类的名字 首选时,登机请求使用语言、文化或命名风格 推断出一个来自UI本地或Pipa的起源.

有意见的工作流程

大部分的代理管弦乐手使用中央协调员. 工作流动情况 计划员或路由器,每个子代理都是为单一工作而创建的,然后 丢弃。 很简单,但它使协调员成为一个瓶颈,而且 交接会失去上下文.

Pipa采取不同的做法: 队友是分散的,自主的 持续.

自治权

队友不等待主干员批准每一步. 它配置它指定的 报告结果。 任务警卫 保持这种自主性:队友必须先履行积极的任务,然后才能完成 可使用非管理工具.

没有中心路由器的协作

队友可以直接交谈.

• teammates → chat 通过ID打开与另一名队友的同步对话. 这是状态检查、验证和调整的默认.
• teammates → send-inbox 给一个忙碌且不应被打断的队友留下同步消息.
• spawnableTeammates 让队友代表特定专家,每个专家都有明确的理由。 审查者可以要求开发者进行更正,也可以要求测试者进行更多的验证,而无需返回主代理.

主干员留监督. 它可以即兴发挥任何队友,但它是 不是在每一次交易的关键道路上.

队友在有用的时候留下来

队友不是一次性工人. 一旦队友有关于 项目、任务历史和以前的决定,其届会仍然可用.

• 这个 online 动作显示哪些队友有活动会话.
• 一个队友只能通过 dismiss有明确的理由,一旦不再需要.
• 任务动作后的可选会话收缩使得长寿的队友无法填补自己的上下文.

flowchart LR
    Main[Main agent / supervisor]
    Specialist[Domain specialist]
    Reviewer[Reviewer]
    Researcher[Researcher]

    Main -->|goal| Specialist
    Main -->|goal| Reviewer
    Specialist <-->|chat| Reviewer
    Reviewer -->|spawnableTeammates| Researcher
    Researcher <-->|inbox / chat| Specialist

工具

任务执行

任务可以包含一个简短的名称,一个详细的描述,硬或软 依赖性 父母的任务 和团队.

依赖性可以是:

• hard: 完全屏蔽执行直到依赖完成.
• soft:记录信息依赖性而不阻碍执行.

队友在调用非管理工具前必须配置指定的任务. 这个 task, (中文(简体) ), teammates,以及 todo 工具仍然可用,以便代理人能够组织 其工作和从缺失的任务中恢复过来。 主要代理人担任主管 并且不受这个守卫的约束.

队友

队友是通过Markdown文件定义的本地专业特工. 管道载荷 与包捆绑在一起的队友和项目队友 .pi/teammates/。 。 。 .

在下放工作之前,代理人可以列出可用的队友. 队友是 附有一个包含必要背景、制约因素的具体目标, 和接受标准.

团队定义

创建诸如 Markdown 文件 .pi/teammates/reviewer.md数字 :

---
name: reviewer
description: Reviews deliverables, verifies requirements, and identifies risks.
thinking: medium
spawnableTeammates:
  specialist: Requests a domain-specific correction
  researcher: Requests additional evidence
---

You are a rigorous reviewer for the domain defined in `.pi/PROFILE.md`.

Review the assigned artifact against its requirements. Identify correctness
issues, missing validation, risks, and unnecessary complexity.

Return actionable findings ordered by severity.

支持的前题字段 :

主干员可以即时通知任何队友. 其他队友只能即兴表演 本人或队友名单 spawnableTeammates。 。 。 .

模型货币

皮帕可以将队友分配到候选模式中,以避免每一次发送 并行代理通过相同的模型队列。 模型循环可以通过 error 或者说 concurrency 事件和通过 pipa.config.ts。 。 。 .

待办事宜列表

这个 todo 工具跟踪当前执行流中的小步骤。 项目 支持状态 pending, (中文(简体) ), in_progress,以及 completed启用 todo 页:1 短清单, task 授权的工作,以及 backlog 长期 项目规划.

项目后置日志

这个 backlog 工具维护持续的项目工作,作为 Markdown 文档 结构化元数据.

• 项目类型: epic, (中文(简体) ), story, (中文(简体) ), task, (中文(简体) ), bugfix。 。 。 .
• 优先事项: low, (中文(简体) ), medium, (中文(简体) ), high, (中文(简体) ), critical。 。 。 .
• 物品可以有一个标题,Markdown正文,状态,域,标记,一个父项,以及任意的JSON元数据.

该工具支持筛选、排序、按标题、代码或标签选择元数据 更新、身体更新和删除.

项目文档

这个 docs 工具维持当地Markdown知识库。 文件支持 标题、摘要、标签、亲子关系、Markdown内容、, 任意的元数据、模糊的搜索、排序和过滤.

这个 publish 动作将文档导出至 Markdown 并生成静态 网站.

权限和护卫

Pipa在工具行刑时增加了护栏 但这不是安全沙盒.

• 终端命令根据命令政策进行验证,被归类为危险命令被屏蔽.
• 队友必须在使用非管理工具之前配置指定的任务.

这些检查补充了皮自己的安全模式. 它们不会取代操作 系统权限、寄存器保护、隔离环境或人 检讨.

二. 背景卫生

长期运行的代理工作流程可以累积被屏蔽的呼叫和被屏蔽的消息. 当一个工具调用因没有任务活动而被屏蔽时, Pipa 会崩溃重复 尝试进入一个单一的通知,所以模型上下文保持干净.

配置

创建 .pi/pipa.config.ts 在项目。 每个选项都是可选的.

export default {
  // Interface and built-in Pipa message language: 'en' or 'pt-BR'.
  locale: 'en',

  // Persist teammate messages.
  persistMessages: false,

  teammate: {
    // How a teammate processes an incoming nudge.
    nudgeMode: 'steer',

    // Hide teammate tool calls from the terminal interface.
    hideTools: false,

    // Hide the model name used by teammates.
    hideModelName: false,

    // Models allowed to run concurrently.
    concurrentlyModels: [],

    cycling: {
      // Events that trigger model rotation: 'error' and/or 'concurrency'.
      events: [],

      // Candidate model IDs used during rotation.
      models: []
    },

    // Compact the teammate session after a task action.
    compactAfterTaskAction: false
  },

  tasks: {
    // Maximum number of tasks displayed simultaneously in the TUI.
    maxVisible: 5
  }
};

在上述默认情况下,项目配置被合并。 矩阵替换 对应的默认数组,而不是被压缩.

本地化

管道支持 en (英文)和 pt-BR (巴西葡萄牙语) 和内置消息。 设定 locale 内 .pi/pipa.config.ts。 。 。 .

登机由一个语言中性快取驱动. 代理人推断或要求 语言,然后确认 简介、生成的技能、队友和文物。 工作语言不是 仅限于 Pipa 支持的界面本地化.

软件包内容

已分发的 Pi 包包括编译的 Pipa 扩展, 语言中性 即时登入,共享管弦乐指令,以及配置模板, 技能、队友、任务和积压物品.

在入职和储存期间产生具体项目的技能和队友 项目之下 .pi/ 目录.

分发

这个 aelinrezende/pipa 库中包含生成的分布文物. 这个 源执行在 pipa-source。释放建立 扩展并发布结果到 GitHub 和 npm。 不编辑分布 直接存储库.

许可证

皮帕根据麻省理工学院的许可证获得执照.