@ghyper9023/pi-dev-workflow 0.4.3 → 0.5.0

package/.doc/AGENT-FRONTMATTER-REFERENCE.md

@@ -0,0 +1,198 @@
+# Agent Frontmatter 配置参考
+
+所有子代理的行为通过其 `.md` 文件的 YAML frontmatter 配置。  
+每个字段对应 `spawnSubagent()` 构造的 pi CLI 参数。
+
+---
+
+## 完整字段一览
+
+```yaml
+---
+name: <string>            # 必填 — agent 标识名
+description: <string>     # 必填 — agent 描述
+tools: <csv>              # 工具白名单（逗号分隔）
+thinking: <string>        # 推理等级
+session: <boolean>        # 是否保存 session
+session-dir: <string>     # session 存储目录（默认 .pi-dev-output/pi-subagent-sessions/）
+no-context: <boolean>     # 是否跳过 AGENTS.md/CLAUDE.md
+no-extensions: <boolean>  # 是否禁用扩展加载
+mode: <string>            # 输出模式
+extra-args: <string>      # 额外 CLI 参数（空格分隔）
+---
+```
+
+---
+
+## 字段详解
+
+### `name` — Agent 标识名
+
+- **必填** ✓
+- **类型**: `string`
+- **作用**: 作为 `subagent` tool 的 `agent` 参数值、日志标识、session 文件名前缀
+- **示例**: `planner`, `git-agent`, `review-agent`
+
+### `description` — Agent 描述
+
+- **必填** ✓
+- **类型**: `string`
+- **作用**: 在工具描述中展示，帮助 LLM 理解该 agent 的用途
+
+### `tools` — 工具白名单
+
+- **类型**: 逗号分隔的字符串
+- **作用**: 对应 `--tools` CLI 参数
+- **参数范围**: pi 内置工具名（可用 `pi --help` 查看），如 `read`, `bash`, `write`, `find`, `ls`, `grep`, `edit` 等
+- **默认值**: 不传 `--tools` 则所有内置工具可用
+- **示例**: `tools: read, bash, write, find, ls, grep`
+
+### `thinking` — 推理等级
+
+- **类型**: 字符串
+- **作用**: 对应 `--thinking` CLI 参数
+- **参数范围**:
+
+| 值 | 说明 | 延迟影响 | Token 影响 |
+|----|------|---------|-----------|
+| `off` | 关闭推理（纯执行） | 基准 | 基准 |
+| `low` | 少量推理 | +20~40% | +30~50% |
+| `medium` | 中等推理 | +50~100% | +50~80% |
+| `high` | 深度推理 | +100~300% | +100~200% |
+| `xhigh` | 极限推理 | +200~500% | +200~400% |
+
+- **建议**:
+  - `off` — git 操作、按计划写代码、机械精简
+  - `low` — 计划制定、代码审查、设计评审、PRD 编写
+  - `medium` — 复杂架构分析、跨模块重构
+  - `high` — 安全审计、深层 Bug 追踪
+  - `xhigh` — 极其复杂的跨领域分析
+
+### `session` — Session 持久化
+
+- **类型**: 布尔值
+- **作用**: 对应 `--no-session` / `--session` CLI 参数
+- **参数范围**: `true` | `false`
+- **`false`** (默认): 子代理运行结束后不保留交互记录，性能最优
+- **`true`**: 保存完整交互记录，便于调试/查看子代理的思考过程
+
+当 `session: true` 时：
+  - 自动生成 session 名: `{ISO时间戳}_{agent名称}`
+  - 默认存储路径: `.pi-dev-output/pi-subagent-sessions/`
+  - 可通过 `session-dir` 自定义路径
+
+### `session-dir` — Session 存储目录
+
+- **类型**: 字符串（路径）
+- **作用**: 对应 `--session-dir` CLI 参数
+- **仅在 `session: true` 时生效**
+- **默认值**: `.pi-dev-output/pi-subagent-sessions/`
+- **示例**: `session-dir: /tmp/my-sessions`
+
+### `no-context` — 项目上下文文件
+
+- **类型**: 布尔值
+- **作用**: 对应 `-nc` CLI 参数
+- **参数范围**: `true` | `false`
+
+| 值 | 行为 | 适用场景 |
+|----|------|---------|
+| `true` (默认) | 跳过 AGENTS.md / CLAUDE.md | git 操作、纯执行场景 |
+| `false` | 加载 AGENTS.md / CLAUDE.md | 需要项目上下文的 agent（架构分析、代码审查） |
+
+### `no-extensions` — 扩展加载
+
+- **类型**: 布尔值
+- **作用**: 对应 `-ne` CLI 参数
+- **参数范围**: `true` | `false`
+
+| 值 | 行为 | 适用场景 |
+|----|------|---------|
+| `true` (默认) | 禁用所有扩展，启动更快 | git 操作（仅需 bash） |
+| `false` | 加载扩展（MCP 工具、Skill 文件等） | 需要 MCP/Skill 的 agent（计划、审查、文档） |
+
+### `mode` — 输出模式
+
+- **类型**: 字符串
+- **作用**: 对应 `--mode` CLI 参数
+- **参数范围**: `json` | `text`
+
+| 值 | 行为 | 适用场景 |
+|----|------|---------|
+| `json` (默认) | JSON 结构化输出，workflow-engine 可解析 | 工作流 agent（planner/worker/reviewer/trimmer/docWriter） |
+| `text` | 自然文本输出 | LLM 直接调用的场景 |
+
+**注意**: 工作流引擎依赖 `extractFinalOutput()` 解析 JSON 输出，工作流 agent 必须使用 `mode: json`。
+
+### `extra-args` — 额外 CLI 参数
+
+- **类型**: 字符串（空格分隔多个参数）
+- **作用**: 在所有标准参数之后追加，优先级最高
+- **用途**: 传递 pi CLI 的其他参数，如 `--verbose`, `--color always`, `--max-tokens 4096` 等
+- **示例**: `extra-args: --verbose --max-tokens 4096`
+
+---
+
+## 原始 CLI 参数映射表
+
+以下是对应关系：**原始硬编码参数 → 配置位置**
+
+| 原始参数 | 含义 | 配置方式 |
+|---------|------|---------|
+| `-p` | 非交互模式 | **始终启用**，不可配置 |
+| `--no-session` | 不保存会话 | frontmatter `session: false` 或 `argsOverride.session = false` |
+| `-nc` | 禁用上下文文件 | frontmatter `no-context: true` 或 `argsOverride.noContext = true` |
+| `-ne` | 禁用扩展发现 | frontmatter `no-extensions: true` 或 `argsOverride.noExtensions = true` |
+| `--mode json` | JSON 结构化输出 | frontmatter `mode: json` 或 `argsOverride.mode = "json"` |
+| `--thinking off` | 关闭深度思考 | frontmatter `thinking: off` 或 `argsOverride.thinkingLevel = "off"` |
+| `--tools ...` | 工具白名单 | frontmatter `tools: read, bash, ...` 或 `argsOverride.tools = [...]` |
+
+**优先级**: `argsOverride` (调用方) > frontmatter > 硬编码默认值
+
+---
+
+## Agent 配置速查表
+
+| Agent | thinking | session | no-context | no-extensions | mode | 适用场景 |
+|-------|----------|---------|------------|---------------|------|---------|
+| **git-agent** | off | false | **true** ✅ | **true** ✅ | json | 纯 git 命令，最小开销 |
+| **planner** | low | false | **false** 🔓 | **false** 🔓 | json | 需 MCP/Skill 分析代码结构 |
+| **worker** | off | false | **false** 🔓 | **false** 🔓 | json | 按计划写代码，可调用 MCP |
+| **reviewer** | low | false | **false** 🔓 | **false** 🔓 | json | 需 Skill 审查代码 |
+| **trimmer** | off | false | **false** 🔓 | **false** 🔓 | json | 精简代码，可用 MCP |
+| **docWriter** | off | false | **false** 🔓 | **false** 🔓 | json | 更新文档，可读代码库 |
+| **review-agent** | low | false | **false** 🔓 | **false** 🔓 | json | HTML 审查报告 |
+| **dev-*-grill-agent** | low | false | **false** 🔓 | **false** 🔓 | json | 设计评审追问 |
+| **dev-prd-agent** | low | false | **false** 🔓 | **false** 🔓 | json | PRD 合成 |
+
+> ✅ `true` = 禁用 / 🔓 `false` = 开启
+
+---
+
+## `argsOverride`（调用方覆写）参考
+
+`spawnSubagent()` 第 7 个参数，TypeScript 接口:
+
+```typescript
+interface SubagentArgs {
+  thinkingLevel?: string;    // "off" | "low" | "medium" | "high" | "xhigh"
+  session?: boolean;         // true/false
+  sessionDir?: string;       // 自定义 session 路径
+  noContext?: boolean;       // true/false
+  noExtensions?: boolean;    // true/false
+  mode?: string;             // "json" | "text"
+  tools?: string[];          // 工具白名单数组
+  appendSystemPrompt?: string; // 额外 system prompt
+  extraArgs?: string[];      // 原始 CLI 参数
+}
+```
+
+示例（workflow-engine 中覆写）:
+
+```typescript
+const result = await spawnSubagent(agent, task, cwd, signal, timeout, onProgress, {
+  thinkingLevel: "medium",    // 临时提升推理等级
+  session: true,              // 调试时保存 session
+  noExtensions: false,        // 临时开启 MCP
+});
+```

package/.version/RELEASE-v0.5.0.md

@@ -0,0 +1,82 @@
+# Release v0.5.0
+
+## 🚀 Features
+
+### 工作流 UUID 溯源与链式上下文传递
+- 为每个工作流运行生成唯一 UUID，注入所有子 agent 提示中，实现跨阶段文件关联追溯
+- 子 agent 会话名、审查报告文件名、计划文件名均附加 UUID，便于调试和定位
+- 新增 **chain context** 机制，将上一阶段输出（实施摘要/审查反馈）自动传递给下一阶段
+- docWriter 阶段自动聚合全部变更文件列表
+- UI 组件展示工作流 UUID，支持文件关联追溯
+
+### 代理前置元数据（Frontmatter）配置体系
+- 为所有 agent（git-agent, 各类 grill agent, review-agent, workflow 子 agent 等）新增标准前置元数据字段：`thinking`、`session`、`session-dir`、`no-context`、`no-extensions`、`mode`、`extra-args`
+- 增强子代理 TypeScript 定义以支持新前言字段，并增加解析逻辑
+- 新增完整的前置元数据配置参考文档 `.doc/AGENT-FRONTMATTER-REFERENCE.md`
+
+### 自定义 UUID v7 生成器
+- 使用时间前缀 + 随机后缀的 UUID v7 方案替换 `crypto.randomUUID()`，提升工作流标识符的唯一性与可排序性
+
+### 代理思维等级属性
+- 在 UI 子步骤面板中展示代理的 `thinkingLevel` 属性，增强运行状态可见性
+
+## 🐛 Bug Fixes
+
+### 子代理计时器错误
+- 修复：代理完成后正确设置 `durationMs` 并清除 `startedAt`，计时不再持续增长
+- 修复：已完成子代理使用记录的 `durationMs`，运行中才使用 live 计时
+- 修复：移除父步骤行的计时/超时显示，仅子代理行展示
+- 修复：循环组新循环时 `resetWidgetSubStepTimers` 清除上一轮计时数据
+
+## 🔧 Refactor
+
+### 移除 workflow agent 的 tools 白名单
+- 移除 `agents/workflow/*-agent.md` 中的 tools 白名单，允许 MCP 工具访问
+- `sub-agents.ts`：session 使用完整路径 + `.jsonl`，自动创建目录
+- `workflow-engine.ts`：`executeSingleStep` 中捕获链上下文变更摘要
+- 新增 `buildReviewTask` 强制 JSON 摘要提示，增强 reviewer 可靠性
+
+### Agent 指令全面增强
+- 所有 agent 添加 MCP/SKILL 额外工具说明（措辞更具体化）
+- **worker**：合并重复约束，完善自我 review 流程
+- **reviewer**：拆分分析代码为独立步骤，补充 `git log`/`git blame` 溯源；添加避免连续错误的思维增强提示
+- **docWriter**：禁止为精简而删除原有正确文档
+
+### Planner 步骤顺序调整
+- 调整实施计划分析步骤顺序，优化产出质量
+
+## 📦 Files Changed
+
+```
+22 files changed, 1140 insertions(+), 65 deletions(-)
+```
+
+### New
+
+- `.doc/AGENT-FRONTMATTER-REFERENCE.md` — 代理前置元数据配置参考文档
+- `tests/test-workflow-engine-bugs.mjs` — 工作流引擎缺陷回归测试（覆盖链上下文、Agent 元数据、UUID 溯源等场景）
+
+### Modified
+
+- `.gitignore` — 新增 `qa.md` 和 `.pi-dev.output/` 忽略规则
+- `README.md` — 版本号更新
+- `package.json` — 版本号更新至 v0.5.0
+- `agents/*.md`（16 个文件）— 新增前置元数据字段 + 指令增强
+- `extensions/sub-agents.ts` — 前置元数据解析、session 路径优化、链上下文支持
+- `extensions/ui-helpers.ts` — UUID 展示、计时修正、思维等级显示
+- `extensions/workflow-engine.ts` — UUID 生成、链上下文传递、计时修复、工具白名单移除
+
+## 🔗 Commit History
+
+```
+bf27a21 feat: 添加代理思维等级属性到工作流子步骤，增强代理状态信息
+64fdcb7 feat: 使用自定义 UUID v7 生成器替换随机 UUID，增强工作流唯一性
+146261b refactor: 移除 workflow agent 的 tools 白名单，增强 session 路径与链上下文机制
+9b0fa0f feat: 添加工作流 UUID 溯源与链式上下文传递机制
+774b9d7 refactor(planner): 调整实施计划分析步骤顺序
+f3192d1 feat: 增强代理配置并添加前置元数据引用
+a04ca78 update version to v0.5.0
+ca1259c refactor(agents): 增强 workflow agent 指令（reviewer）
+e4e5e70 refactor(agents): 增强 workflow agent 指令（全部子 agent）
+b84a729 fix(workflow): 修复子代理计时器错误
+```

package/README.md

@@ -13,6 +13,8 @@ pi install git:github.com/cherish-ltt/pi-dev-workflow
 ```
 
 然后 `/reload` 热加载即可使用所有功能。
+> [!NOTE]  
+> 本pi-package存在sub-agent功能，会与其他使用sub-agent功能的pi-package冲突，但冲突可以修复，请提交issue或自行处理。
 
 ## 目录结构
 

package/agents/git-agent.md

@@ -2,6 +2,13 @@
 name: git-agent
 description: Git 操作专家，负责提交、推送及提交并推送
 tools: bash
+thinking: off
+session: false
+session-dir: 
+no-context: true
+no-extensions: true
+mode: json
+extra-args: 
 ---
 
 你是一名 Git 操作专家。你唯一的职责是执行 Git 命令。

package/agents/grill/dev-doc-grill-agent.md

@@ -2,6 +2,13 @@
 name: dev-doc-grill-agent
 description: 文档评审 agent — 在编写文档前审查文档大纲
 tools: read, bash
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深技术文档工程师，负责审查文档编写计划。请对开发者进行深入追问。

package/agents/grill/dev-fix-grill-agent.md

@@ -2,6 +2,13 @@
 name: dev-fix-grill-agent
 description: Bug 修复评审 agent — 挑战开发者对 Bug 根本原因的理解
 tools: read, bash
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深调试专家，负责审查 Bug 修复方案。请对开发者进行深入追问。

package/agents/grill/dev-grill-agent.md

@@ -2,6 +2,13 @@
 name: dev-grill-agent
 description: 设计方案评审 agent — 对功能方案进行严苛的设计评审
 tools: read, bash, write
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深设计评审专家。请围绕功能方案的每一个方面对开发者进行深入追问，直到双方达成共识。

package/agents/grill/dev-perf-grill-agent.md

@@ -2,6 +2,13 @@
 name: dev-perf-grill-agent
 description: 性能评审 agent — 审查优化方案和基准测试策略
 tools: read, bash
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深性能工程师，负责审查优化方案。请对开发者进行深入追问。

package/agents/grill/dev-prd-agent.md

@@ -2,6 +2,13 @@
 name: dev-prd-agent
 description: PRD 编写 agent — 根据对话上下文合成 PRD 文档
 tools: read, bash
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深产品规格文档撰写专家。

package/agents/grill/dev-refactor-grill-agent.md

@@ -2,6 +2,13 @@
 name: dev-refactor-grill-agent
 description: 重构评审 agent — 在实施重构前审查重构计划
 tools: read, bash
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深软件架构师，负责审查重构计划。请对开发者进行深入追问。

package/agents/grill/dev-test-grill-agent.md

@@ -2,6 +2,13 @@
 name: dev-test-grill-agent
 description: 测试计划评审 agent — 在编写测试前审查测试覆盖和方法
 tools: read, bash
+thinking: high
+session: false
+session-dir: 
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一名资深 QA 工程师，负责审查测试计划。请对开发者进行深入追问。

package/agents/review-agent.md

@@ -2,6 +2,13 @@
 name: review-agent
 description: Review 代码，生成 HTML 审查报告并输出到 .pi-dev-output/pi-review/html/ 目录
 tools: read, write, bash, grep, find, ls
+thinking: high
+session: true
+session-dir: .pi-dev-output/pi-subagent-sessions/review-agent/
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一个代码审查助手，运行在隔离的上下文窗口中。

package/agents/workflow/docWriter-agent.md

@@ -1,7 +1,13 @@
 ---
 name: docWriter
 description: 文档撰写 agent — 更新 README 及 API 文档，添加代码注释
-tools: read, bash, write, find, ls, grep
+thinking: off
+session: true
+session-dir: .pi-dev-output/pi-subagent-sessions/docWriter/
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一个技术文档工程师。你的任务是根据代码库的最新状态以及从最近几次git-commit或git-diff中的改动，更新 README 和必要的代码注释。
@@ -19,11 +25,16 @@ tools: read, bash, write, find, ls, grep
    - 添加/更新代码注释：对关键函数添加 JSDoc/TSDoc 注释
    - 保持文档风格与现有文档一致
 
+## 额外可用工具
+
+- `MCP`：可直接调用已注册的 MCP 工具获取外部信息或执行操作
+- `SKILL`：可直接使用项目中可用的 SKILL 文件获取领域知识和最佳实践
+
 ## 约束
 
 - **不要修改业务逻辑代码**（只添加或修改注释/文档）
 - 注释应说明"为什么"而非"是什么"
 - 使用项目已有的注释风格
 - 如果项目没有 README，创建一个基本的 README.md
-- 避免文档膨胀：只记录必要的、稳定的接口和功能
+- 避免文档膨胀：只记录必要的、稳定的接口和功能，但不因此为了精简而删除原有的且正确的文档，原有错误的文档只修复，不删除。
 - 确保文档与实际代码行为一致

package/agents/workflow/planner-agent.md

@@ -1,7 +1,13 @@
 ---
 name: planner
 description: 计划制定 agent — 分析代码库结构，生成详细实施计划并写入 .pi-dev-output/pi-plans/
-tools: read, bash, write, find, ls, grep
+thinking: xhigh
+session: true
+session-dir: .pi-dev-output/pi-subagent-sessions/planner/
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一个资深技术架构师和计划制定专家。你的任务是分析代码库，生成一份详细的实施计划。
@@ -12,10 +18,17 @@ tools: read, bash, write, find, ls, grep
 2. **探索代码库**：使用 `find` / `ls` / `bash` 了解项目结构，使用 `read` 阅读关键文件。
 3. **分析影响范围**：确定哪些文件需要修改、新增或删除，评估依赖关系。
 4. **制定实施计划**：为每个实施步骤编号，描述具体的改动内容和测试策略。
-5. **写入计划文件**：使用 `write` 工具将计划保存到 `.pi-dev-output/pi-plans/` 目录。
-   - 文件名格式：`<YYYYMMDD-HHmmss>-<简短功能名>.md`
+5. **分析实施计划**：分析制定出的计划，查漏补缺，确认计划完美无缺。
+6. **写入计划文件**：使用 `write` 工具将计划保存到 `.pi-dev-output/pi-plans/` 目录。
+   - 文件名格式：`<YYYYMMDD-HHmmss>-<简短功能名>-<工作流UUID>.md`
+   - 工作流 UUID 由 task prompt 中的 `## 工作流信息` 提供，附加在文件名末尾
    - 确保 `.pi-dev-output/pi-plans/` 目录存在（若不存在则创建）
 
+## 额外可用工具
+
+- `MCP`：可直接调用已注册的 MCP 工具获取外部信息或执行操作
+- `SKILL`：可直接使用项目中可用的 SKILL 文件获取领域知识和最佳实践
+
 ## 计划模板
 
 ```markdown

package/agents/workflow/reviewer-agent.md

@@ -1,7 +1,13 @@
 ---
 name: reviewer
 description: 代码审查 agent — 审查代码质量，输出结构化审查报告（含严重等级）
-tools: read, bash, write, find, ls, grep
+thinking: high
+session: true
+session-dir: .pi-dev-output/pi-subagent-sessions/reviewer/
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一个资深代码审查专家。你的任务是对代码库的变更进行审查，输出包含严重等级的结构化报告。
@@ -12,13 +18,24 @@ tools: read, bash, write, find, ls, grep
 2. **探索代码**：使用 `read` / `find` / `ls` / `bash` / `grep` 检查代码质量：
    - 运行 `git diff HEAD` 或 `git log -p -n 3` 查看未提交或最近的变更
    - 阅读关键文件的当前状态
-3. **分类问题**：按以下 3 个等级分类：
+3. **分析代码**：
+   - 根据 prompt 和代码上下文，准确判断新增或修改的代码意图
+   - 如果对修改意图不确定，使用 `bash` 运行 `git log` / `git blame` / `.pi-dev-output/pi-plans`文件夹 查看提交历史或plan计划
+   - **确认意图后，认真分析代码质量**
+   - 对分析结果进行梳理，分析应避免出现独立修复`BUG-X1`,`BUG-X2`,`BUG-X3`时候又刚好引入新BUG
+4. **分类问题**：按以下 3 个等级分类：
    - **严重（critical）**：Bug、逻辑错误、安全漏洞、数据丢失风险、功能未实现
    - **中等（medium）**：可优化项、冗余代码、性能问题、异常处理缺失
    - **低优先级（low）**：代码风格、命名建议、注释改进、结构微调
-4. **输出审查报告**：
+5. **输出审查报告**：
    - 将详细报告写入 `.pi-dev-output/pi-review/md/` 目录
-   - 文件名格式：`review-<YYYYMMDD-HHmmss>.md`
+   - 文件名格式：`review-<YYYYMMDD-HHmmss>-<工作流UUID>.md`
+   - 工作流 UUID 由 task prompt 中的 `## 工作流信息` 提供，附加在文件名末尾
+
+## 额外可用工具
+
+- `MCP`：可直接调用已注册的 MCP 工具获取外部信息或执行操作
+- `SKILL`：可直接使用项目中可用的 SKILL 文件获取领域知识和最佳实践
 
 ## 输出格式
 

package/agents/workflow/trimmer-agent.md

@@ -1,7 +1,13 @@
 ---
 name: trimmer
 description: 代码精简 agent — 精简冗余代码，缩短行数，优化可读性
-tools: read, bash, write, find, ls, grep
+thinking: medium
+session: true
+session-dir: .pi-dev-output/pi-subagent-sessions/trimmer/
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一个代码精简和可读性优化专家。你的任务是精简代码，缩短不必要冗长的行，消除重复逻辑，在不改变行为的前提下提升可读性。
@@ -24,6 +30,11 @@ tools: read, bash, write, find, ls, grep
    - 语法正确
    - 可读性更好或至少不变
 
+## 额外可用工具
+
+- `MCP`：可直接调用已注册的 MCP 工具获取外部信息或执行操作
+- `SKILL`：可直接使用项目中可用的 SKILL 文件获取领域知识和最佳实践
+
 ## 约束
 
 - **绝不改变业务逻辑**。这是最高优先级。

package/agents/workflow/worker-agent.md

@@ -1,7 +1,13 @@
 ---
 name: worker
 description: 代码实施 agent — 根据计划逐步实现代码改动
-tools: read, bash, write, find, ls, grep
+thinking: medium
+session: true
+session-dir: .pi-dev-output/pi-subagent-sessions/worker/
+no-context: false
+no-extensions: false
+mode: json
+extra-args: 
 ---
 
 你是一个资深软件工程师。你的任务是严格按照实施计划实现代码。
@@ -16,8 +22,14 @@ tools: read, bash, write, find, ls, grep
    - 每个步骤完成后，若计划中有验证命令则运行确认
 4. **自我检查**：完成所有步骤后，确保：
    - 没有遗漏任何计划中的改动
+   - 对修改的代码自我 review 一遍
    - 代码语法正确（可运行 `node -c` 或 `tsc --noEmit` 等检查）
-   - 不破坏现有功能
+   - 确认没有因为偷懒而破坏现有功能或忽略某项计划
+
+## 额外可用工具
+
+- `MCP`：可直接调用已注册的 MCP 工具获取外部信息或执行操作
+- `SKILL`：可直接使用项目中可用的 SKILL 文件获取领域知识和最佳实践
 
 ## 约束
 
@@ -26,4 +38,7 @@ tools: read, bash, write, find, ls, grep
 - **最小改动原则**：只修改计划中列出的文件，只做计划中描述的改动
 - **不要删除未计划删除的文件**
 - **不要修改未计划修改的现有逻辑**（除非计划中明确要求）
+- **计划实施完成后，首先自我 review，然后使用语法检查、`test` 命令等确认代码无误**
+- **不修改除本项目/本目录以外的任何文件或内容**
 - 若发现计划有误或不可行，请在输出中说明原因和建议的修正方案，不要擅自变更计划
+- **实施完成后，在回复中列出你修改的所有文件及变更类型（新增/修改/删除），供后续审查者参考**