pi 任务
用于会话范围工作和待办事宜跟踪的 Pi 扩展名 .
它补充说:
WorkCreate, (中文(简体) ),WorkList, (中文(简体) ),WorkUpdate,以及WorkDeleteTodoCreate, (中文(简体) ),TodoList, (中文(简体) ),TodoUpdate,以及TodoDeleteTaskTimeExport财务报告和审定财务报表TaskTimeImport用于计量授权工作/works,之后模拟的详细浮动仪表板pi-loop-monitor是因为/monitors- 紧凑的浮上右上方面板,上面有工作名称和待办事宜名称、完成百分比和测量的活动时间
- 主对话指导,将正常要求的工作贯穿每个 Pi 技能,要求每个授权代理在分配工作前建立自己的工作和托多ID
工作和待办事宜跟随活跃的Pi会话分支. 伪造或导航会话树恢复该分支的状态. /ask 财务报告和审定财务报表 /btw 对话不更新作品,待办事宜,循环,或显示器.
协调模式有意是小的:一个作品是一组具有共同上下文且无地位的任务,一个待办事宜是具有自身地位的具体步骤,一个显示器运行一个长寿的背景指令,一个循环调度一个未来或反复唤醒的时间. 循环和监视器仍为 pi-loop-monitor。 。 。 .
跟踪指南需要在全球安装 implement (c) 在保留专门技能权限的同时,将技能作为每个跟踪工作,包括工人-当地工作的协调工作流程。 Pi-tasks拥有记录/进展, implement 拥有任务所有权决定和工艺品路径,以及 herdr 拥有授权代理生命周期。 使用存储器的根状文物 var/<sessionId>/<workId>/<taskId>/;孩子将自己的会话/工作/任务路径嵌入到父任务目录下. 每个任务记录 self 或者说 delegate 有个原因 taskInfo。这些是指令,而不是运行时间执行、共享跨会话记录或自动技能安装器。 缺少所需的技能、工具或ID 阻断执行 /ask编号 :/btw 仍在工作流程之外。 见 使用指南 和完整的合同.
安装
pi install npm:@abhishek944/pi-tasks
重新启动 Pi 或运行 /reload。 。 。 .
使用
扩展引导 Pi 为开始或继续工作的正常请求自动管理工作. 您也可以直接调用工具 :
WorkCreate workName="Add task tracking" workInfo="Detailed goal, scope, constraints, and expected outcome"
TodoCreate workId="W1" taskName="Implement state" taskInfo="Detailed task context and expected result" status="active"
TodoUpdate taskId="T1" working=true
TodoUpdate taskId="T1" completionPercent=40 taskInfo="The state changes are implemented; rendering and verification remain."
TodoUpdate taskId="T1" status="completed" taskInfo="Implementation is complete; typecheck and build passed."
WorkUpdate workId="W1" workInfo="Task tracking is implemented; state and UI checks passed."
运行 /works 完全检查 workInfo 财务报告和审定财务报表 taskInfo 在交互式的覆盖中.
作品是没有地位的收藏. 任务使用四个状态 : active (默认), blocked, (中文(简体) ), completed,以及 cancelled启用 blocked 一旦下一步必须等待代理输出,审查,外部响应,用户输入,权限,或者其他障碍. 供应 blockedReason 当创建被封锁的任务或进入被封锁状态时,解释依赖性并恢复状态; 保留进度。 原因在其他被屏蔽的编辑过程中被保留,离开被屏蔽时被清除. 没有任何理由的旧记录仍然可以读取。 父母委托的任务在等待工人产出时被冻结;工人自己的地方任务可能很活跃。 AgentCreate 在成功创建后自动屏蔽母任务,保留其进度. 对于手工授权,请标记明确被阻断的母任务. 当依赖解决并恢复工作时,将被封锁的任务恢复为活动。 状况本身并没有安排一个觉醒的时间。 遗留任务保存状态 planned 财务报告和审定财务报表 pending 恢复为活动; 忽略旧的工作状态。 工作工具不再接受状态或状态过滤器. 取消整个工作,取消剩余的任务; WorkDelete仍然删除收藏及其任务.
Pi报告通过现有 TodoCreate编号 :TodoUpdate 使用可选工具 completionPercent (从0到100的整数,或 null 页:1 工作进展是未取消任务的平均平均数,四舍五入,而不是已完成任务的一小部分。 例如,任务值100,40,0,0给出工作进度35%. 缺失的估计使工作进度不明(—);被封锁的任务保留其估计值. 已完成的任务为100%;报告100个未完成的状况被拒绝。 对于较长的任务,指导要求皮在大约5至10个有意义的工作步骤或里程碑之后列入临时估计数,而不是等待完成。 估计数仍然是可选的,必须有证据支持;这是指导,而不是强制执行的时间表。 这些百分比是估计数,而不是时间预测。 浮动面板将百分比保留在保留右边一栏中,如此长的名称无法隐藏。 现有的键盘控制不变.
活动任务时间
小组和 /works 储备金 完成 财务报告和审定财务报表 时间 栏。 选择您正在实际工作的任务 TodoUpdate taskId="T1" working=true它必须活跃并且有 owner: self 详细内容。 选择另一个任务暂停上一个任务 。 使用 working=false 暂停而不改变状态。 在每个新运行的开头再次选择; 仅仅创建或标记一个活动的任务从不启动计时器 .
扩展用途 Date.now() 添加工作间隔,包括思考和前景工具。 闲置时间, 代理循环之间的本地重试延迟, 屏蔽用户提示不计数 。 完成, 屏蔽, 取消, 所有权更改, 中止, 关闭自动停止计时器 。 已保存的总数幸存了重新加载和分支导航;恢复的任务被暂停,离线时间从不计数. 运行时间有一个 ▶ 标记。 总和在间隔边界上保存, 而不是每个显示勾选 。 强制进程杀死会失去当前未保存的间隔 。 屏蔽即时排除需要一个 Pi 主机来释放 ui_prompt_start编号 :ui_prompt_end; 旧主机仍然暂停在代理- loop 边界上 .
新任务开始于 0s; 没有显示时间的历史任务 — 直到测量, 不试图重建更早的时间。 工作时间是每个任务所衡量的努力的总和,包括被取消的任务;任何未知的任务都使得总和不明. 它不是墙上时间,也不是对剩余时间的估计。 每个受委托的代理人都会为自己的本地任务提供时间. Agent Create提供时间报告路径;工人打电话 TaskTimeExport 完成后的任务编号。 父母打电话来 TaskTimeImport 拥有授权的任务ID。 母任务和工作包括量度的努力,而不计等待或改变地位。 在进出口之前,下放的工作显示 —。重复进口取代了累积快照而不是再次添加快照。 见 授权时间。列表和复制的Markdown包含相同的总数.
小组和 /works 前缀带有ID的工作名和带有ID加所有权的任务名,例如 [W1] Locate subagent restrictions 财务报告和审定财务报表 [T1] [self] Inspect the implement skill任务所有权来自明确 owner: self 或者说 owner: delegate 在行的开头声明 taskInfo; 保存在更新上. 裁决缺失或冲突表明 [unassigned],不重写存储的名字或旧记录。 在赫尔德内部, AgentCreate 自动将其任务链接到下划线, 可点击 [delegate] 徽章; 打开的动作也下划线。 见 代表窗格链接 用于链接和键盘访问.
面板默认为浮上右上方布局. 压缩头不再显示会话ID 。 除了 Copy 外, 还有一个下划线的 Open会话动作, 使用配置的命令打开此代理服务器的文物文件夹, 包括现有的嵌入式授权路径; 如果不存在, 它会创建 var/<sessionId>/。现有的 Open 仍然打开仓库。 使用 /works-panel open-session 不使用鼠标输入。 窄头缩短最小化/最大化 [-]编号 :[+]编辑 /works 仪表盘标题保持不变。 它的顶端边框中心是当前寄存器的 Git 分支, 以及舞台/ 未舞台/ 未跟踪文件计数, 与一秒缓存同步刷新 。 清理仓库显示 clean。在全屏 TUI 模式下,其标题栏有可点击的 Copy, Open, 并最小化/ 最大化动作, 您可以直接用鼠标方向盘滚动溢出行 。 打开默认值到 cursor .; 配置 pi-tasks.openCommand 用于使用其他工具(参见 配置) (中文(简体) ). 打开 /works 检查键盘上的每行或副本。 使用 /works-panel minimize, (中文(简体) ), /works-panel maximize,或 /works-panel open 当鼠标输入不可用时。 单位 /works按钮 o 以运行已配置的命令。 切换布局 /works-panel floating, (中文(简体) ), /works-panel widget,或 /works-panel off。 。 。 .
任务所属代理人
AgentCreate, (中文(简体) ), AgentList, (中文(简体) ), AgentStatus, (中文(简体) ), AgentOutput, (中文(简体) ), AgentSend, (中文(简体) ), AgentInterrupt, (中文(简体) ), AgentClose,以及 AgentFocus 直接使用 paneId 的简单 Herdr CLI 包装器。 AgentCreate还注册了pi-loop-monitor并返回ID并加上一个已准备好的任务;确认MonitorList显示已准备好订阅,然后AgentSend it. onSignal 提醒父为工人状态变化; 可选 onDone 手柄监视终止,而不是任务完成。 没有登记、启动收据、流程检查或自动收回。 创建/关闭需要现代的Pi嵌入调用并更新pi-loop-monitor元数据;不依赖pi-herdr-agents. 见 代理工具。 。 。 .
可选自动续读
在 Pi 1. 2. 0 或更新时, 启用您的全球或可信任的项目中未完成的工作续作 settings.json数字 :
{
"pi-tasks": {
"autoContinue": { "enabled": true }
}
}
它默认关闭。 奥米 maxContinuations ,或添加正整数,例如 "maxContinuations": 10 盖住它。 无限制的续作可以在未完成的记录保留的情况下无限期地消耗令牌;人工中止和其他停止条件仍然适用. 在正常的用户请求运行成功或失败后,Pi会继续,同时当前会话分支上所有Works上的任何任务都会被激活. 被屏蔽,完成或被取消的任务不会引发续作;遗留计划/待完成的任务状态恢复为活作. 逃脱/破坏会停止流动;只有新接受的主交互或RPC会运行重装. 扩展提醒不会重新武装它或者重设限制 。 限制计算每个新主用户运行所要求的续作,而不是美元或工具呼叫. 已排队的引导/后续输入不重设 。 编辑设置后重新装入 .
自动接续使用皮的原生前定居边界,排队后的工作,再试,并收紧. 失败运行不解除它: 在 Pi 的本土重试完成后, 未完成的记录要求再次续作 。 它没有可用的跟踪工具,也没有仅仅因为恢复会话而开始工作。 它从不改变任务状态,也不能独立证明完成。 旧主机保留了没有此功能的普通跟踪.
见 使用指南 财务报告和审定财务报表 参考文献。 。 。 .
发展
npm run lint
npm run typecheck
npm run build
npm run audit:production