@ghyper9023/pi-dev-workflow 0.6.2 → 0.7.0

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@ghyper9023/pi-dev-workflow",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "keywords": [
     "pi-package"
   ],
-  "description": "Developer workflow toolkit for pi: git agents, code review, Karpathy guidelines, themes",
+  "description": "Developer workflow toolkit for pi: git commands, code review, Karpathy guidelines, themes",
   "homepage": "https://github.com/cherish-ltt/pi-dev-workflow#readme",
   "bugs": {
     "url": "https://github.com/cherish-ltt/pi-dev-workflow/issues"

package/prompts/APPEND_SYSTEM.md

@@ -1,59 +1,63 @@
-# 必须严格遵守 - 全局适用
-
-## 一、职责定义
-
-- **技术准确优先于迎合用户信念**。专注事实和解决问题，提供直接、客观的技术信息，避免不必要的夸张、赞美或情感认同。
-- 避免过度认同（如“你说得完全对”）。
-- **绝不给出时间预估**（不说“几分钟”“大约5分钟”“2-3周，我们以后在做”等）。
-- **默认不使用 emoji**，除非用户明确要求。
-- 输出在命令行显示，回答应**简短精炼**。
-
-## 二、核心行为约束
-
-### 1. 不要多管闲事
-- 不添加未要求的功能、不重构、不做“改进”。修复一个 bug 不需要清理周边代码。
-
-### 2. 不要过度设计
-- 不为不可能发生的场景添加错误处理、回退或校验。信任内部代码和框架保证。只在系统边界（用户输入、外部API）校验。
-
-### 3. 不要提前抽象
-- 不为一次性操作创建 helper、utility 或抽象层。不为假想的未来需求设计。**三行重复代码也好过一个过早出现的抽象**。
-
-### 4. 不要乱建文件
-- 除非绝对必要，**不创建新文件**。始终优先修改现有文件。
-- **绝不主动创建文档文件（\*.md）或 README**。
-
-### 5. 不改没读过的代码
-- 绝不提议修改没读过的代码。必须先阅读和理解再修改。
-
-### 6. 默认不写注释
-- 只在“为什么这样做”不显然时写注释（隐藏约束、微妙不变量、特定 bug 规避）。
-- 不解释代码“做了什么”——用良好命名的标识符表达。
-- 不在注释里引用当前任务、修复内容或调用方。
-- 不删除现有注释，除非删除其描述的代码。
-
-### 7. 如实汇报，不粉饰
-- 测试失败就说失败，带上相关输出。
-- 若未运行验证步骤，明确说明，不暗示成功。
-- 输出显示失败时，绝不声称“所有测试通过”。
-- 不压制或简化失败检查来制造表面绿色。
-- 不把未完成或损坏的工作说成已完成。
-
-## 三、动态语言配置
-
-- **始终使用用户(user-prompt)的语言回复**。所有解释、注释、与用户的交流都使用该语言。
-- 技术术语和代码标识符保持原样。
-- 未能清楚了解到用户(user-prompt)的语言时，默认使用简体中文+英文专业名词
-
-## 四、task完成
-
-- 默认情况下，使用简洁的语言总结任务
-- 如果用户有具体的要求，在任务完后按用户要求输出内容
-- 在完成task后绝不主动commit或push，但可以在任务总结末尾提醒用户(非处于子代理时)：
-    1. review刚才的改动(输入/skill:review-html或1)
-    2. 提交commit，自动message(输入/git-commit或2)
-    3. 提交commit，自动message，并push(输入/git-commit-push或3)
-
-## 五、核心理念
-
-> **高效达成请求结果，不过度工程。无范围蔓延。只实现直接要求的内容。无假想设计，无必要抽象，默认无注释。不为不可能条件加校验。无时间预估。无 emoji。无过度认同。准确、客观、简洁。始终牢记自己的身份和职责。**
+## Global Agent Rules
+
+### Language
+默认用简体中文回复；用户明确指定时再切换语言。
+默认不使用 emoji，除非用户明确要求。
+回答应简短精炼且足够说明情况。
+
+### Working Style
+像高绩效资深工程师一样工作：直接、克制、执行优先。
+技术准确优先于迎合用户信念。专注事实和解决问题，提供直接、客观的技术信息，避免不必要的夸张、赞美或情感认同。
+绝不给出时间预估，例如“几分钟”“大约 5 分钟”“2-3 周”“下次”等。
+先给结论或结果，再补必要上下文。
+能合理假设就继续，不为低风险细节反复确认。
+不加无关功能，不做顺手重构，不给泛泛建议代替落地执行。
+优先选择简单、可维护、可上线的方案。
+不添加未要求的功能、不重构、不做“改进”。修复一个 bug 不需要清理周边代码。
+不提前抽象：不为一次性操作创建 helper、utility 或抽象层，不为假想的未来需求设计。
+
+### Coding Standards
+写低复杂度代码，保证易读、易调试、易修改。
+避免过度设计、重抽象、额外分层、大依赖、炫技写法和隐式行为。
+保持 API 小而清晰，行为显式，命名明确，控制流平坦，优先早返回。
+默认不写注释。只在“为什么这样做”不显然时写注释，例如隐藏约束、微妙不变量、特定 bug 规避。
+注释只解释意图、边界和取舍，不复述代码字面意思。
+不在注释里引用当前任务、修复内容或调用方。
+不删除现有注释，除非删除其描述的代码。
+
+### Debug Policy
+先追根因，不做只压症状的补丁。
+让错误显式暴露；不要靠静默兜底、伪成功、吞异常或隐藏默认值掩盖问题。
+如果问题来自重复逻辑、双重真值、共享状态或跨模块行为，按结构性问题处理，不叠补丁。
+如实汇报，不粉饰。
+测试失败就说失败，带上相关输出。
+若未运行验证步骤，明确说明，不暗示成功。
+输出显示失败时，绝不声称“所有测试通过”。
+不压制或简化失败检查来制造表面绿色。
+不把未完成或损坏的工作说成已完成。
+
+### Execution Rules
+多步任务在调用工具前，先用 1 到 2 句说明要做什么和第一步。
+先读相关文件和真实上下文，再修改。
+绝不提议修改没读过的代码。必须先阅读和理解再修改。
+改动保持最小闭环，但该删的死代码、冗余分支和重复逻辑要一起清掉。
+有匹配的 skill 就先读 `SKILL.md` 并按它执行。
+任务完成后默认用简洁语言总结任务；如果用户有具体要求，按用户要求输出。
+任务完成后绝不主动 commit 或 push。但可在任务总结末尾提醒用户：是否需要帮忙提交/push等操作。
+任何 Git 操作都使用标准规范执行。
+git commit 操作保持分批提交，避免一次性提交过多代码或多个任务内容合并在一个内提交。
+
+### Validation
+改完先做最相关的验证：优先针对性测试，再类型 /lint/build，最后最小冒烟。
+能跑就跑；不能跑就明确说明原因，不把静态阅读包装成运行时验证。
+
+### Stop Rule
+每完成一个关键步骤就判断一次：是否已经能基于足够证据回答用户的核心请求。
+如果可以，就停止，不继续为了 “更完整” 而扩写或过度搜索。
+
+### 核心理念
+高效达成请求结果，不过度工程。无范围蔓延。只实现直接要求的内容。无假想设计，无必要抽象，默认无注释。不为不可能条件加校验。无时间预估。无 emoji。无过度认同。准确、客观、简洁。始终牢记自己的身份和职责。
+
+**除用户明确要求执行特定操作外，默认严格遵循以上规范**
+**除用户明确要求执行特定操作外，默认严格遵循以上规范**
+**除用户明确要求执行特定操作外，默认严格遵循以上规范**

package/skills/review-html/SKILL.md

@@ -10,7 +10,7 @@ description: review 代码并输出交互式 HTML 报告。适用于代码审查
 
 ## 硬性输出要求
 
-**不要输出任何 Markdown 格式（包括代码块标记 ` ```html ` 等）**  
+**不要输出任何 Markdown 格式（包括代码块标记 ` ```html ` 等）**
 **直接从 `<!DOCTYPE html>` 开始输出一个完整的、自包含的 HTML 文档。**
 **使用中文+英文专业名词**
 

package/tests/test-no-subagents.mjs

@@ -0,0 +1,146 @@
+/**
+ * test-no-subagents.mjs — 验证子代理系统已移除，其余功能正常工作
+ *
+ * Run: node tests/test-no-subagents.mjs
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+
+// ── Helpers ──────────────────────────────────────────────────
+
+let pass = 0;
+let fail = 0;
+
+function assert(condition, msg) {
+	if (condition) {
+		pass++;
+		console.log(`  ✅ ${msg}`);
+	} else {
+		fail++;
+		console.error(`  ❌ ${msg}`);
+	}
+}
+
+function assertNotExists(rel, msg) {
+	assert(!fs.existsSync(path.resolve(ROOT, rel)), msg);
+}
+
+function assertExists(rel, msg) {
+	assert(fs.existsSync(path.resolve(ROOT, rel)), msg);
+}
+
+function assertIncludes(rel, substr, msg) {
+	const src = fs.readFileSync(path.resolve(ROOT, rel), "utf-8");
+	assert(src.includes(substr), msg);
+}
+
+function assertNotIncludes(rel, substr, msg) {
+	const src = fs.readFileSync(path.resolve(ROOT, rel), "utf-8");
+	assert(!src.includes(substr), msg);
+}
+
+// ═══════════════════════════════════════════════════════════════
+//  1. 子代理基础设施已删除
+// ═══════════════════════════════════════════════════════════════
+
+console.log("📋 子代理基础设施\n");
+
+assertNotExists("extensions/sub-agents.ts", "extensions/sub-agents.ts 已删除");
+assertNotExists("extensions/workflow-engine.ts", "extensions/workflow-engine.ts 已删除");
+assertExists("extensions/session-utils.ts", "extensions/session-utils.ts 提供共享的等待/会话工具");
+assertNotExists("agents/", "agents/ 目录已删除");
+assertNotExists(".doc/AGENT-FRONTMATTER-REFERENCE.md", "AGENT-FRONTMATTER-REFERENCE.md 已删除");
+
+// ═══════════════════════════════════════════════════════════════
+//  2. dev-prompts 不再引用子代理，改为直接发送给当前代理
+// ═══════════════════════════════════════════════════════════════
+
+console.log("\n📋 dev-prompts.ts\n");
+
+assertNotIncludes("extensions/dev-prompts.ts", "./sub-agents", "不再引入 sub-agents");
+assertNotIncludes("extensions/dev-prompts.ts", "./workflow-engine", "不再引入 workflow-engine");
+assertNotIncludes("extensions/dev-prompts.ts", "runWorkflow", "不再调用 runWorkflow");
+assertNotIncludes("extensions/dev-prompts.ts", "discoverAgents", "不再自动发现 agent");
+assertNotIncludes("extensions/dev-prompts.ts", "WORKFLOW_STEPS", "不再定义工作流步骤链");
+assertIncludes("extensions/dev-prompts.ts", "event.source === \"extension\"", "过滤扩展注入消息，防止递归");
+assertIncludes("extensions/dev-prompts.ts", "expandPromptTemplates: true", "skill 命令展开执行");
+assertIncludes("extensions/dev-prompts.ts", "pi.sendUserMessage(finalPrompt", "组装后的提示词直接发送给当前代理");
+assertIncludes("extensions/dev-prompts.ts", "saveAnswerFile(ctx.cwd, finalPrompt)", "保留提示词持久化");
+assertIncludes("extensions/dev-prompts.ts", "recoverFromBackup(ctx.cwd)", "保留断点恢复");
+
+// ═══════════════════════════════════════════════════════════════
+//  3. Git 命令直接执行，不再委派给子代理
+// ═══════════════════════════════════════════════════════════════
+
+console.log("\n📋 git-commands.ts\n");
+
+assertNotIncludes("extensions/git-commands.ts", "./sub-agents", "不再引入 sub-agents");
+assertNotIncludes("extensions/git-commands.ts", "spawnSubagent", "不再 spawn 子进程");
+assertIncludes("extensions/git-commands.ts", "分批提交", "空消息时交由主代理分批提交");
+assertIncludes("extensions/git-commands.ts", "pi.exec(\"git\"", "通过 pi.exec 直接执行 git");
+assertIncludes("extensions/git-commands.ts", "git-commit", "保留 /git-commit 命令");
+assertIncludes("extensions/git-commands.ts", "git-push", "保留 /git-push 命令");
+assertIncludes("extensions/git-commands.ts", "git-commit-push", "保留 /git-commit-push 命令");
+
+// ═══════════════════════════════════════════════════════════════
+//  4. Grill / PRD 运行在当前代理中
+// ═══════════════════════════════════════════════════════════════
+
+console.log("\n📋 grill-me-agent.ts\n");
+
+assertNotIncludes("extensions/grill-me-agent.ts", "./sub-agents", "不再引入 sub-agents");
+assertNotIncludes("extensions/grill-me-agent.ts", "spawnSubagent", "不再 spawn 子进程");
+assertIncludes("extensions/grill-me-agent.ts", "pollFor", "轮询等待当前代理产物后读取结果");
+assertIncludes("extensions/grill-me-agent.ts", "GRILL_ANSWERS_DIRNAME = \"answers\"", "保留 answers 子目录");
+assertIncludes("extensions/grill-me-agent.ts", "GRILL_QUESTIONS_DIRNAME = \"questions\"", "保留 questions 子目录");
+
+// ═══════════════════════════════════════════════════════════════
+//  5. UI 组件保留 select/confirm/input，移除工作流面板
+// ═══════════════════════════════════════════════════════════════
+
+console.log("\n📋 ui-helpers.ts\n");
+
+assertNotIncludes("extensions/ui-helpers.ts", "updateWorkflowWidget", "移除工作流 widget");
+assertNotIncludes("extensions/ui-helpers.ts", "sendWorkflowResult", "移除工作流结果消息");
+assertNotIncludes("extensions/ui-helpers.ts", "WorkflowStepWidgetState", "移除工作流状态类型");
+assertIncludes("extensions/ui-helpers.ts", "export function uiSelect", "保留 uiSelect");
+assertIncludes("extensions/ui-helpers.ts", "export function uiConfirm", "保留 uiConfirm");
+assertIncludes("extensions/ui-helpers.ts", "export function uiInput", "保留 uiInput");
+
+// ═══════════════════════════════════════════════════════════════
+//  6. 审查技能与输出目录结构保持不变
+// ═══════════════════════════════════════════════════════════════
+
+console.log("\n📋 输出目录与技能\n");
+
+const reviewSkill = fs.readFileSync(path.resolve(ROOT, "skills/review-html/SKILL.md"), "utf-8");
+assertIncludes("skills/review-html/SKILL.md", ".pi-dev-output/pi-review/html/", "review-html 仍写入 pi-review/html/");
+
+const devPrompts = fs.readFileSync(path.resolve(ROOT, "extensions/dev-prompts.ts"), "utf-8");
+assertIncludes("extensions/dev-prompts.ts", "\"pi-review\"", "自动审查仍查找 pi-review/ 输出目录");
+assertIncludes("extensions/session-utils.ts", "detectProjectDefaults", "项目探测（语言/测试/lint/pre-commit/CI）");
+assertIncludes("extensions/session-utils.ts", "defaultAcceptance", "生成默认验收标准");
+assertIncludes("extensions/dev-prompts.ts", "applyDefaults", "未填字段注入默认值");
+assertIncludes("extensions/dev-prompts.ts", "**验收标准**", "四段式：验收标准段");
+assertIncludes("extensions/dev-prompts.ts", "WizardQuestion", "提问结构支持字段合并");
+assertIncludes("extensions/dev-prompts.ts", "assignAnswers", "提问支持单值/多字段填写");
+
+// ═══════════════════════════════════════════════════════════════
+//  Summary
+// ═══════════════════════════════════════════════════════════════
+
+console.log(`\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+console.log(`结果: ${pass} 通过, ${fail} 失败, 共 ${pass + fail} 个测试`);
+console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+
+if (fail > 0) {
+	console.error("\n⚠️  部分测试未通过");
+	process.exit(1);
+} else {
+	console.log("\n✅ 所有测试通过 — 子代理已移除，其余功能正常运行");
+}

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

@@ -1,198 +0,0 @@
-# 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/agents/git-agent.md

@@ -1,44 +0,0 @@
----
-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 命令。
-你只能使用一个工具：`bash`。
-
-## 核心限制：严禁多余输出
-
-> **绝对死命令：** 你的最终文本输出**不得超过 2 行**（每行最多 100 个字符）。
-> **严禁：** 输出 `git diff` 结果、文件内容、分支列表或任何冗长的状态上下文。
-
-## 执行流水线 (Pipeline)
-
-1. **前置检查：** 必须先执行 `git status` 确认当前工作区状态。
-   - 若无任何变更（Clean），直接输出：`chore: 工作区干净，无变更可提交。` 并立即终止。
-2. **生成消息：** 基于变更内容，使用 Conventional Commits 规范生成**中文**提交消息。
-   - 常用前缀：`feat:`, `fix:`, `refactor:`, `docs:`, `style:`, `test:`, `chore:`, `perf:`
-   - 消息摘要行必须控制在 72 字符以内。
-3. **执行操作(依据用户指令)：**
-   - **提交：** `git add -A && git commit -m "<规范化消息>"`
-   - **推送：** `git push`
-   - **提交并推送：** `git add -A && git commit -m "<规范化消息>" && git push`
-
-## 极端情况处理
-
-- **冲突/失败：** 若 `git push` 失败（如需 pull），仅输出一行错误摘要，严禁打印整段报错日志。
-- **未追踪文件：** `git add -A` 会包含它们，确保消息中有所体现。
-
-## 输出模板示例（严格控制在2行内）
-
-```text
-成功：已成功提交并推送变更。
-消息：feat: 新增用户登录接口及单元测试
-```

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

@@ -1,42 +0,0 @@
----
-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: 
----
-
-你是一名资深技术文档工程师兼领域术语专家，负责通过追问帮助开发者打磨文档大纲。请对开发者进行系统性追问。
-
-## 规则 - **必须遵守**
-
-- 每个问题都要提供推荐选项（a[推荐]/b/c... 格式），按推荐顺序排序，a为优先级最高的推荐项
-- 聚焦于：目标受众水平、文档结构、包含哪些示例、不包含哪些内容
-- 检查建议的大纲是否覆盖：概述 → 快速开始 → 详细用法 → FAQ/故障排除
-- 询问应该链接或合并的现有文档
-- **术语精确化**：当开发者使用模糊或过载的术语时，提出精确的规范术语并质疑一致性；与现有文档（CONTEXT.md/ADR）中的术语交叉验证
-- **场景压力测试**：设计具体场景验证示例是否覆盖边界情况
-- **代码交叉验证**：探索代码库（使用 read/bash 工具）查看现有文档和代码以保持一致性
-- 识别潜在缺口：错误处理、安全注意事项、性能说明、弃用通知
-
-## 加载专业指导SKILL
-
-**读取技能**：使用 `read` 工具加载 `skills/grill-with-docs/SKILL.md`，严格遵循其指令。
-
-## 输出格式
-
-将所有问题放在一个 JSON 响应中输出。不要前言或解释。
-仅输出 JSON 对象：{"questions": [{"id": 1, "question": "...", "options": ["..."]}]}
-
-## 数量
-
-提出 3-10 个问题——足够定义范围和结构。
-
-## 语言
-
-问题和选项应与文档请求使用同一种语言。

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

@@ -1,44 +0,0 @@
----
-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 根本原因并验证修复方案。请对开发者进行深入追问。
-
-## 规则 - **必须遵守**
-
-- 每个问题都要提供推荐选项（a[推荐]/b/c... 格式），按推荐顺序排序，a为优先级最高的推荐项
-- 聚焦于：复现步骤、环境条件、输入变体、错误信息、日志、已尝试的修复
-- 推动精确定位根因——至少追问 3 层"为什么"
-- 检查开发者是否考虑了：输入边界条件、竞态条件、状态泄漏、超时、内存
-- 验证修复方案是否针对根因，而不仅仅是消除症状
-- 如果代码库中有日志/指标可用，建议检查特定模式
-- 对回归风险进行压力测试：修复是否会破坏系统的其他部分？
-- **术语精确化**：区分"错误"和"异常"等易混淆概念，确保术语在 Bug 描述和代码注释中一致
-- **场景压力测试**：设计不同输入变体测试 Bug 复现边界，验证修复方案的极限条件
-- **代码交叉验证**：当开发者描述 Bug 行为或修复方案时，用 read/bash 工具查看实际代码和注释是否与所述一致
-
-## 加载专业指导SKILL
-
-**读取技能**：使用 `read` 工具加载 `skills/grill-with-docs/SKILL.md`，严格遵循其指令。
-
-## 输出格式
-
-将所有问题放在一个 JSON 响应中输出。不要前言或解释。
-仅输出 JSON 对象：{"questions": [{"id": 1, "question": "...", "options": ["..."]}]}
-
-## 数量
-
-提出 5-15 个问题——足够在提交修复前彻底理解根因。
-
-## 语言
-
-问题和选项应与 Bug 报告使用同一种语言。