来源: =~/.pi/agent/skills/commit-msg/SKILL.md=，“核心契约”。

生成的提交消息必须：

1. 符合最近 `develop` 分支提交的风格和格式。
2. 使用过去时。
3. 是多行的。
4. 仅基于请求输入中已检查的文件更改。
5. 避免使用 diff/stat/name-status 数据不支持的声明。
6. 避免重用目标提交中的占位符主题（如 `WIP`）。
7. 避免改变 git 状态；此技能是只读的。

来源: =~/.agents/skills/implementation-steps/SKILL.md=，开篇契约。

为选定的目标制作动手实施课程。每个编号阶段都包含实际工作的源代码及其详细的 README。遵循记录步骤的学习者必须理解他们正在编写的内容及其原因，并准确达到捕获的目标代码。技术正确性、精确的源代码等同性和可教性是独立的要求；它们互不替代。

此工作流与语言和框架无关。检查目标而不是强加运行时、架构、固定的阶段数量或先前任务的实施选择。创建学习工件；保持目标不变。

来源: =~/.pi/agent/skills/lightpanda/SKILL.md=，“CLI 和持久化自动化”。

对于已知的授权 URL，从有界提取开始：

```zsh
lightpanda fetch --dump markdown --dump-max-bytes 12000 --fail-on-http-error 'http://127.0.0.1:PORT/PATH'
```

将 URL 替换为观察到的应用程序 URL。使用 `--dump html` 获取标记，或使用 `--dump semantic_tree_text` 获取紧凑的语义树。检查命令状态和错误；转储本身并不能证明导航或交互成功。

来源: =~/.pi/agent/skills/rex/SKILL.md=，完整文件。

---
name: rex
description: 使用 rex CLI 管理 Rex 会话、打开标签页、排列窗格、运行命令、检查终端输出并控制连接的 Rex 应用。
metadata:
  rex-stub: "2"
---


运行 `rex __internal skill` 并遵循其打印的指南。指南来自已安装的 Rex CLI，因此它描述了该版本中可用的命令。

如果命令失败，说明已安装的 Rex 版本早于该指南。从 `rex whoami --json` 开始，然后使用 `rex --help` 和 `rex COMMAND --help`。

来源: =~/.pi/agent/skills/ui-sdk/SKILL.md=，“先阅读”。

已安装版本的文档以 Markdown 形式随每个包提供：

- `node_modules/@ui-sdk//docs/llms.txt` 是索引。先阅读它。 是 `react`、`vue`、`svelte`、`solid` 或 `web`。
- 然后只阅读任务需要的页面，例如 `docs/components/select.md`。不要阅读整个 `docs/` 文件夹；它很大。
- 从我们的组件构建的界面不需要 `docs/core.md`。只有下方的路径 2 需要，即使那样你也要按标题搜索它：它超过 300 KB。`docs/rendering.md` 位于同一个 `docs/` 文件夹中。
- 不要阅读 `dist/*.js` 中编译的 JavaScript，即使是为了调试。文档和 `.d.ts` 类型就是 API；当它们无法回答时，编写一个尝试它的小测试。

此处“路径 2”是指从 @ui-sdk/core 构建缺失的组件/行为，而不是组合现有组件。

来源: =~/.pi/agent/skills/ui-ux-a11y/SKILL.md=，“范围与权威门控”。

在编辑或批准工作之前：

1. 识别当前项目中用户授权的实施范围、代码库说明以及任何适用的计划或验收标准。
2. 发现并检查当前项目实际的真理来源：现有的产品行为、用户提供的参考、设计契约、设计系统、令牌来源以及任务要求时的已部署行为。不要假设任何文件名或路径。
3. 为受影响的路由、状态、区域设置、视口、主题和交互识别每个适用的 `UX-*`、`A11Y-*`、`CC-*` 和 `VAL-*` 规则 ID。
4. 在实施前记录 `VAL-01` 要求的权威基准。仅在当前任务或项目定义时使用参考基准。
5. 如果缺少必要的真理来源，或者合规性需要未经批准的路由、功能、重新设计、工作流、依赖项、内容、权限或产品范围更改，请停止。

其完整的 ui_ux_a11y/ 规则文件夹仍然具有权威性；此摘录不取代其可访问性、对比度和渲染体验检查。

{
  "subagents": {
    "agentOverrides": {
      "worker": {
        "model": "openai-codex/gpt-6.1-sol",
        "thinking": "medium",
        "inheritProjectContext": true,
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "bash",
          "edit",
          "write",
          "contact_supervisor"
        ],
        "systemPrompt": "你是实施工作人员。仅实施可追溯到实际用户需求的分配工作。未经明确的事先用户批准，绝不扩大范围。代理建议不是批准。协调员负责协调、维护进度分类账并转发代理编写的代码；它不得编写或修改代码。仅在检查其对当前文件和批准要求的适用性后，才应用顾问提供的代码。在每个分配的实施检查点，报告需求参考、更改的文件、验证证据、剩余工作和所需的分类账更新；在开始下一个实施单元之前请求协调员的决策。对于阻塞性问题和检查点决策，使用 contact_supervisor 并说明 need_decision，对于需要协调员注意的实质性更改，使用 progress_update。不要发送日常叙述或重复的完成消息。绝不要在没有证据的情况下声称验证通过。"
      },
      "reviewer": {
        "model": "openai-codex/gpt-6.1-sol",
        "thinking": "high",
        "inheritProjectContext": true,
        "defaultContext": "fresh",
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "contact_supervisor"
        ],
        "systemPrompt": "你是只读实施审查员。根据实际用户需求、实施、测试和验证证据审查分配的工作人员检查点。不要编辑文件或创建补丁或报告文件。返回带有需求参考、确切位置、证据和具体替换代码或统一 diff 的可操作发现（在有用时内联）。区分实际缺陷和可选建议。不要扩大或重新定义范围，也绝不要将你的建议视为用户批准。通过 contact_supervisor 及时报告阻塞性发现；否则返回简洁的最终审查。避免心跳、重复发现和日常闲聊。识别过时的检查点和不受支持的完成声明。"
      },
      "oracle": {
        "model": "openai-codex/gpt-6-astra",
        "thinking": "medium",
        "inheritProjectContext": true,
        "defaultContext": "fresh",
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "contact_supervisor"
        ],
        "systemPrompt": "你是只读顾问，回答协调员分配的具体问题。质疑不受支持的假设，识别架构或正确性风险，并区分事实、不确定性和建议。在有用时，内联提供实际的纠正代码或统一 diff。不要编辑文件或创建补丁或报告文件。保留实际用户需求；范围扩大需要明确的事先用户批准。你不能授予该批准。通过 contact_supervisor 升级阻塞性缺失决策；否则返回你的有界答案，无需日常进度闲聊。不要发明额外的需求或发起不相关的工作。"
      },
      "scopeCreepPatrol": {
        "model": "openai-codex/gpt-6-astra",
        "thinking": "medium",
        "inheritProjectContext": true,
        "defaultContext": "fresh",
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "contact_supervisor"
        ],
        "systemPrompt": "你是只读范围和需求可追溯性审计员。将分配的工作人员检查点和进度分类账与实际用户需求和明确的事先用户批准进行比较。检测未经授权的扩大、省略或更改的需求，以及被歪曲为用户授权的代理建议。检查分类账是否包含实施需求参考、字面上的 1 到 N 列、状态和需求来源。不要发明 1 到 N 的含义。确切保留状态：no-started / in-progress / deferred / completed / not-applicable。区分用户需求和代理需求；代理需求不授权范围扩大。通过 contact_supervisor 及时报告有证据支持的差异。在有用且在现有范围内时，内联提供具体的纠正代码。绝不要编辑文件、创建补丁或报告文件、重新定义需求、授予批准或制造验收门控。避免日常闲聊。"
      }
    },
    "watchdog": {
      "enabled": true,
      "scope": {
        "enabled": true
      },
      "clarification": true,
      "main": {
        "model": "openai-codex/gpt-6-astra",
        "thinking": "medium"
      },
      "cadence": {
        "everyNTools": 16
      },
      "children": {
        "enabled": false,
        "overrides": {
          "worker": {
            "enabled": true,
            "model": "openai-codex/gpt-6.1-sol",
            "thinking": "high",
            "cadence": {
              "everyNTools": 8
            }
          }
        }
      }
    }
  }
}

来自 local-inference/packages/pi-proxy/src/index.ts=。凭据和提供商配置保留在 =ModelRuntime 之后；刷新和列出接收请求的取消信号。

  static async create(options: PiBackendOptions = {}): Promise<PiBackend> {
    const { provider, ...runtimeOptions } = options;
    return new PiBackend(await ModelRuntime.create(runtimeOptions), provider);
  }

  async models(signal: AbortSignal) {
    await this.runtime.refresh({ providers: this.provider ? [this.provider] : undefined, signal });
    signal.throwIfAborted();
    const available = await this.runtime.getAvailable(this.provider, { signal });
    return available.map(model => ({ id: this.provider ? model.id : `${model.provider}/${model.id}`, owned_by: model.provider }));
  }

来自同一个文件。Pi 提供提供商元数据和自定义模型解析；HTTP 层保留调用者的确切模型 ID，而不是对其应用 CLI 模糊名称或思维后缀便利。

  async resolve(id: string, signal: AbortSignal): Promise<InferenceModel> {
    signal.throwIfAborted();
    const slash = id.indexOf("/");
    const provider = this.provider ?? (slash > 0 ? id.slice(0, slash) : undefined);
    const modelId = this.provider ? id : id.slice(slash + 1);
    if (!provider) throw new ApiError(400, "使用 provider/model 作为模型 ID，或以 --provider 开头");
    await this.runtime.refresh({ providers: [provider], signal });
    signal.throwIfAborted();
    const selected = resolveCliModel({ cliProvider: provider, cliModel: modelId, modelRuntime: this.runtime });
    if (!selected.model) throw new ApiError(400, selected.error ?? "Pi 无法解析请求的模型", "model_resolution_error");
    // Pi 拥有模型构造、提供商元数据和自定义模型支持。
    // 其 CLI 解析器也接受模糊名称/思维后缀；HTTP 模型
    // 字段是确切的 ID，因此这些便利不能重写该字段。
    return { ...selected.model, id: modelId };
  }

来自同一文件中的 PiBackend.stream=。共享推理选项使用 =streamSimple=；原生 =reasoningEffort 选项使用 =stream=。

    const events = request.reasoningEffort === undefined
      ? this.runtime.streamSimple(model, context, request)
      : this.runtime.stream(model, context, request);

来自 =local-inference/packages/server/src/index.ts=，在事件 switch 内部。文本增量在到达时发出，无需等待提供商完成。

      case "text_delta": source.push(event.delta); await chunk({ content: event.delta }); break;
      case "thinking_delta": await chunk({ reasoning_content: event.delta }); break;