@fan92rus/pi-goal-x

中文文档
0.36.1-fan.1发布于 2026/10/28MITES Module零依赖构建来源已验证近 30 天下载 2881

在pi中增加/目标:对话目标规划、灵活或有秩序的目标、持续的进展以及独立的完成审计员.

中文使用文档
文档目录9 节
  1. 安装
  2. 创建目标
  3. 目标类型
  4. 任务和子任务
  5. 完成审计员
  6. 进展和目标控制
  7. 图标
  8. 设置
  9. 许可证
pi-goal-x logo

目标十

添加数 /goal 函数改为 毕。代理人帮助您定义目标并计划,继续自动地工作,并将结果提交给可选的独立完成审计员.

延长可节省会议的目标、任务和进展。 您可以随工作变化而暂停、恢复、修改或切换目标.

安装

pi install npm:pi-goal-x

创建目标

/goal Add CSV export to the reports page, with documentation and tests.

代理人与您讨论目标,在需要时提出重点问题,并提出目标、任务计划和完成要求。 您审查提案并选择是否使用完成审计员。 一旦确认,代理开始工作并在目标活动时自动继续.

可以指定完成要求,例如通过测试套件,或者用每个需要的章节制作报告. 特工跟踪任务和子任务,记录证据,并努力达到这些要求. 如果它被阻断,需要你的投入,你可以解决问题并恢复.

如果您已经有一个完整的目标, 请使用 /goal-direct <objective> 创建目标,并立即开始而不起草.

目标类型

类型行为示例用途
经常 —— 说 /goal实现的结果,由代理人选择和调整计划.特征、调试、研究和文献.
锡斯活 —— 说 /sisyphus命令一个计划 使特工一步一步走.移徙、造就和释放程序.

对于一个被命令的目标,您可以提供步骤或者用代理人定义它们:

/sisyphus Migrate authentication in this order:
1. Add the new token validator.
2. Update login and session refresh to use it.
3. Remove the old validator.
4. Run the authentication tests.

使用 /sisyphus-direct <objective> 在不起草的情况下启动命令目标.

任务和子任务

代理可以将一个目标分为任务和子任务,每个任务都描述了完成它所需的部分工作. 在引导目标设定过程中,您在工作开始前先审查拟议计划.

例如,CSV出口目标可以有这一任务计划:

Add CSV export to reports
├─ Review the report data and active filters
├─ Implement CSV export
│  ├─ Generate the CSV from filtered results
│  └─ Add a download button
├─ Test the export
└─ Document how to use it

随着工作的进展,代理标记当前的任务,记录已完成的工作,并解释任何被跳过的任务. 仪表板显示已做和尚存的工作,包括子任务内的进展。 当您暂停并保留在以后的会话中时, 任务进度会被保存 .

任务也可以有自己的完成要求——例如,“下载只包含匹配活动过滤器的行。” 代理人根据这些要求记录证据,完成审计员在审查总体结果时使用这些证据.

使用 /goal-tweak <change> 讨论修改目标及其计划。 任务跟踪、完成要求和子任务深度可配置于 /goal-settings。 。 。 .

完成审计员

如果启用,则在目标被接受为完整之前,由单独的代理人对工作进行审查。 它检查目标、任务、记录的证据、完成要求和工作空间.

如果审计师批准,目标存档为完整. 如果确定未得到满足的要求,目标仍然开放,并有反馈说明仍需开展的工作。 您可以在 /goal-settings 目标的审计 Ctrl+Shift+A。 。 。 .

进展和目标控制

编辑器上方的仪表板显示目标状态,任务进度,当前任务,已过时间,以及符号用法. 新闻 Ctrl+Shift+T 以扩展它,用于完整的任务树、完成要求、证据和最近的活动。 审计进展和结果也出现在那里.

一个项目可以有几个公开目标,每届有一个重点目标。 切换为 /goal-focus暂停 /goal-pause,或使用 /goal-tweak 讨论当前目标的变化。 按键 Esc 在积极工作期间也暂停了目标;在被扩展的仪表板中,它会使视图崩溃.

图标

命令它会做什么
/goal [idea]讨论、规划和确认一个常规目标.
/sisyphus [idea]讨论、计划、确认目标.
/goal-direct <objective>立即创建并启动常规入球.
/sisyphus-direct <objective>立即创建并启动已命令的入球 .
/goal-list列出开放目标.
/goal-status显示重点目标及其进展.
/goal-focus选择一个开放的目标来工作 .
/goal-unfocus保持当前目标开放,而不注重目标.
/goal-tweak <change>与代理修改当前目标 .
/goal-pause暂停重点目标的工作.
/goal-resume恢复已暂停或被阻挡的入球 .
/goal-clear确认后归档重点目标.
/goal-cancel取消未确认的草稿 .
/goal-settings配置目标行为和审计员.

用于解决问题,使用 /goal-status verbose 更详细, /goal-status health 或者说 /goal-recovery 检查问题,以及 /goal-refresh 在外部变化后重新装入已保存的目标和设置. /goal-recovery repair 在确认后提供修理.

设置

打开 /goal-settings 更改这些选项。 您可以保存所有工程的默认值, 覆盖当前工程的默认值, 或者删除一个覆盖以使用所继承的值 .

设置它控制着什么
明确执行合同strictExecutionContract(中文(简体) )瞄准准备/ 等待协议, 并进行一个缺少决定的修复, 然后暂停 。 默认为 false:成功处决自动继续.
自主管理津贴(maxAutonomousRuns(中文(简体) )每个创建或 /goal-resume 期间. 未设定表示无限;0会禁用自动续作. 设置在不重置使用的情况下编辑限制.
自动运行线路( E)showAutonomousRuns(中文(简体) )控制 Autonomous runs: N/limit 线条,用于有限的备抵。 默认为 true。 。 。 .
任务跟踪disableTasks(中文(简体) )打开或关闭任务列表 。 设定为 true 以禁用它们.
自主任务突变( E)autonomousTasks(中文(简体) )让代理添加和重组目标任务和子任务而不要求确认. 默认为 false: 代理提议任务树, 您确认对话框 .
子任务深度( N)subtaskDepth(中文(简体) )限制代理可以创建多少个子任务的级别 .
完成要求(disableContracts(中文(简体) )打开或关闭明确的目标和任务完成要求。 设定为 true 以禁用它们.
无重点提醒( E)hideUnfocusedPrompt(中文(简体) )当某会场没有重点目标,但选定集合中存在开放式目标时,代理人收到 [PI GOAL UNFOCUSED] 提醒每个请求。 设定为 true 以停止提醒。 默认为 false。这独立于 hideUnfocusedBanner,只隐藏未聚焦部件和状态提示。 不设置选择或恢复一个目标; 单独的 autoSelectSingleGoal 设置仍然适用.
审计员已残疾关闭独立完成审查.
审计提供者、模式和思维层面选择哪个模式审查完成了工作及其推理工作.

许可证

麻省理工学院

版本与发布记录

@fan92rus/pi-goal-x 共发布 23 个版本,首次发布于 2026/10/13;过去 12 个月发布了 23 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.36.1-fan.1latest2026/10/2817 天前
0.36.1-fan.02026/10/2817 天前
0.34.1-fan.12026/10/2817 天前
0.34.1-fan.02026/10/2817 天前
0.36.0-fan.32026/10/2717 天前
0.36.0-fan.22026/10/2717 天前

其他发布通道:fan → 0.32.3-fan.1。

关于 @fan92rus/pi-goal-x 的常见问题

@fan92rus/pi-goal-x 是什么?

在pi中增加/目标:对话目标规划、灵活或有秩序的目标、持续的进展以及独立的完成审计员.

如何安装 @fan92rus/pi-goal-x?

在项目目录运行 npm install @fan92rus/pi-goal-x,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(^1.3.11)、@earendil-works/pi-ai(>=1.4.0 <2.0.0)、@earendil-works/pi-tui(>=1.4.0 <2.0.0)、@earendil-works/pi-coding-agent(>=1.4.0 <2.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 pi-goal-x-recover,可以用 npx pi-goal-x-recover 直接运行。

@fan92rus/pi-goal-x 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fan92rus__pi-goal-x 是否存在。

@fan92rus/pi-goal-x 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fan92rus/pi-goal-x 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fan92rus/pi-goal-x 可以商用吗?

@fan92rus/pi-goal-x 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fan92rus/pi-goal-x 的下载量有多少?

根据 npm 官方下载统计,@fan92rus/pi-goal-x 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,881 次,日均约 96 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fan92rus/pi-goal-x 还在维护吗?

最新版本 0.36.1-fan.1 发布于 2026/10/28(17 天前);至今共发布 23 个版本,其中过去 12 个月发布了 23 个;首次发布于 2026/10/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。