@ghyper9023/pi-dev-workflow 0.1.7 → 0.2.0

package/README.md

@@ -34,6 +34,8 @@ pi-package/
 │   └── review-html/
 │       └── SKILL.md                 # 代码审查 → 输出交互式 HTML 报告
 ├── extensions/
+│   ├── dev-prompts.ts               # 提示词优化向导（/dev-* 命令）
+│   ├── git-commands.ts              # git-sub-agent 命令
 │   └── sub-agents.ts                # 子代理系统：git-sub-agent + review-sub-agent
 └── themes/
     └── claude-code-theme.json       # Claude Code CLI 风格主题
@@ -85,6 +87,75 @@ LLM 也可以直接调用 `subagent` 工具委派任务给任意子代理：
 |---|---|
 | **claude-code-theme** | 仿 Claude Code CLI 配色：深色底 + 琥珀金主色 + 紫罗兰辅色 |
 
+## Dev Prompts（提示词优化向导）
+
+基于 [ai提示词优化.md](./ai%E6%8F%90%E7%A4%BA%E8%AF%8D%E4%BC%98%E5%8C%96.md) 中的优质模板，通过交互式问答引导你填写 `[xxx]` 占位符，组装完整的高质量提示词后直接投递给主代理执行。
+
+### 命令一览
+
+| 命令 | 用途 | 对应模板类型 |
+|---|---|---|
+| `/dev-feat` | 新功能/创意生成 | `feat` |
+| `/dev-fix` | 问题排查/错误修正 | `fix` |
+| `/dev-doc` | 文档生成/总结 | `doc` |
+| `/dev-refactor` | 重构/优化现有结构 | `refactor` |
+| `/dev-test` | 测试用例生成 | `test` |
+| `/dev-chore` | 日常维护/自动化 | `chore` |
+| `/dev-perf` | 性能优化 | `perf` |
+| `/dev-style` | 风格/格式调整 | `style` |
+| `/dev-security` | 安全审查 | `security` |
+| `/dev-explain` | 概念解释 | `explain` |
+| `/dev-compare` | 对比评估 | `compare` |
+
+### 使用方法
+
+输入任意 `/dev-*` 命令进入向导，按提示逐项填写字段：
+
+```text
+# 示例：/dev-feat
+📋 /dev-feat — 新功能/创意生成，请逐项填写以下信息（留空跳过对应段落，Esc 取消）
+
+编程语言/框架？ TypeScript
+技术栈？ NestJS + Prisma
+目标模块/文件名？ src/auth/login.ts
+核心功能描述？ 用户可以通过邮箱+密码注册并登录
+...
+✅ 提示词已组装完成，正在发送给主代理...
+```
+
+**交互规则**：
+- **留空（直接回车）** — 该字段标记为「无」，对应的模板段落整段跳过
+- **输入「无」** — 与留空效果相同，明确表示不需要该段内容
+- **按 Esc** — 随时退出向导，不产生任何输出
+- **填写后** — 自动用 `pi.sendUserMessage()` 投递给主代理，立即开始执行
+
+### 示例 1：用 `/dev-fix` 修 Bug
+
+```text
+/dev-fix
+文件路径？ src/api/users.ts
+行号？ 42
+Bug 描述？ 创建用户成功后返回 201，但实际上返回了 500
+输入/现象？ POST /api/users 正确参数返回 Internal Server Error
+预期行为？ 返回 201 + 用户数据
+当前错误？ 500 Internal Server Error
+```
+
+组装后的提示词包含：根因诊断 → 修复方案 → 测试复现 → diff 输出。
+
+### 示例 2：用 `/dev-doc` 写文档
+
+```text
+/dev-doc
+模块/API 名称？ AuthService REST API
+目标受众？ 前端开发者和后端集成方
+关键信息点？ 注册、登录、刷新 token、登出四个接口的用法
+示例语言？ TypeScript, curl
+已有材料？ （留空跳过，从零生成）
+```
+
+组装后的提示词包含：角色（技术文档工程师）→ 大纲先行 → Markdown 层级文档 → 2 个可运行示例。
+
 ## Skills
 
 | Skill | 来源 | 说明 |

package/ai/346/217/220/347/244/272/350/257/215/344/274/230/345/214/226.md

@@ -0,0 +1,341 @@
+# 🧠 AI 编程提示词模板库（按 Git Commit 类型分类）
+
+> 融合 **Anthropic / Claude Code 官方最佳实践**、**OpenAI Codex CLI 文档**、**社区 1000+ 提示词审查** 以及 **吴恩达提示词工程课程** 的核心原则，提供可直接复制、填充的提示词模板。  
+> 覆盖 `feat` `fix` `doc` `refactor` `test` `chore` `perf` `style`，并补充 `security` 等高频类型。
+
+---
+
+## 🧩 通用骨架（适用于所有类型）
+
+每个高质量提示词都应包含以下结构，优先保证 **角色 + 任务 + 上下文** 清晰：
+
+```text
+[类型] 简短标题（≤50字符）
+
+**角色**：你是一个资深 [语言/框架/领域] 工程师/专家。
+**背景/上下文**：项目技术栈、关键约束、当前现状、目标受众。
+**具体任务**：明确要做什么，精确到文件/函数/行号。
+**输出格式**：指定 diff / Markdown / 表格 / 列表 / 代码块等。
+**验证指令**：要求 AI 提供自检方法（测试命令、预期输出、性能基准）。
+**硬性约束**：禁止的行为（NEVER）、必须保持的规则、最小改动原则。
+**深度思考**：对复杂问题要求列出权衡方案，客观分析利弊，避免谄媚。
+```
+
+> ⚠️ 关键原则：**上下文精准 · 验证驱动 · 极简主义 · Plan 先行 · 硬性约束 · 对抗谄媚**
+
+---
+
+## 1. `feat` — 新功能 / 创意生成
+
+> 核心口诀：**Plan 先行，验证兜底**  
+> 适合场景：头脑风暴新方案、功能设计、产品创意、模块开发
+
+### 📝 详细版模板
+```text
+[feat] 在 [模块/文件] 中实现 [功能描述]
+
+**角色**：你是一个资深 [TypeScript / Python / Rust] 工程师。
+**背景**：项目使用 [技术栈，如 NestJS + Prisma]，当前缺少 [具体能力]，用户痛点是 [具体痛点]。
+**任务**：
+1. 先分析代码库结构，给出逐步实施计划（列出要修改/创建的文件、数据库迁移、对现有代码的假设）。
+2. 计划经我确认后再编写代码。
+3. 实现后编写测试用例验证核心逻辑，并运行 [测试命令] 确认通过。
+**输出**：提供 unified diff 和两句话的变更说明。
+**约束**：禁止顺手重构无关代码；保持所有公共 API 签名兼容；不要为假设性需求添加抽象层。
+**验证**：运行 [npm test / cargo test] 确保无回归。
+```
+
+### ⚡ 精简版模板
+```text
+Plan first — no code yet.
+Implement [功能] in @file:[路径]。
+Tech: [框架/库]。
+Write a test to verify, then run [命令]。
+```
+
+### 🔑 关键提示
+- 涉及 >2 个文件时，必须先进入 **Plan Mode**，Review 计划后动手。
+- 明确 **角色 + 任务 + 上下文**，开局第一句话决定成败。
+- 要求 AI 提供 **验证自己工作的方法**（测试、截图、预期输出），这是最高杠杆的实践。
+
+---
+
+## 2. `fix` — 问题排查 / 错误修正
+
+> 核心口诀：**根因修复，不消除症状**  
+> 适合场景：调试代码、修正逻辑错误、分析失败原因
+
+### 📝 详细版模板
+```text
+[fix] 修复 @file:[文件路径] #L[行号] 中的 [Bug 描述]
+
+**背景**：
+- 输入：[粘贴出错内容或描述现象]
+- 预期行为：[正确的结果]
+- 当前错误：[错误信息/不符合预期的输出]
+**任务**：
+1. 不要仅仅消除报错（Suppress），要解决根本原因。
+2. 先读取相关代码和日志，诊断根因（多步推理，不要先给结论）。
+3. 提供至少一种修复方案，并说明为什么这样做。
+4. 编写测试用例复现该 Bug 并确认修复有效。
+**输出**：提供 diff 和两句话的根因分析。
+**约束**：只修 bug，不做重构；最小化改动；不要假设错误是微不足道的。
+**验证**：运行 [测试命令] 确认修复。
+```
+
+### ⚡ 精简版模板
+```text
+Fix root cause, not the symptom.
+@file:[路径] #L[行号] — [Bug 简述]。
+Diagnose before patching. Minimum change only.
+Write a test to verify.
+```
+
+### 🔑 关键提示
+- 明确 **诊断先于修补**，防止 AI 用 try-catch 吞掉错误。
+- 精确指定 **文件和行号**，避免 AI 通读整个仓库。
+- 要求 **编写测试** 来复现 Bug，确保修复有效且不会回归。
+
+---
+
+## 3. `doc` — 文档生成 / 总结
+
+> 核心口诀：**面向读者，结构优先**  
+> 适合场景：撰写说明、注释、会议纪要、API 文档、README
+
+### 📝 详细版模板
+```text
+[doc] 为 [模块/API] 撰写一份 [用户手册 / API 文档 / 决策报告]
+
+**角色**：你是一位技术文档工程师。
+**背景**：目标受众是 [小白 / 前端开发者 / 架构师]，他们需要了解 [关键信息点]。
+**已有材料**：[上传文件 / 粘贴原始笔记]
+**任务**：
+1. 提取核心要点，按逻辑结构重组（概述 → 快速开始 → 详细说明 → 常见问题）。
+2. 添加至少 2 个真实可运行的示例（使用 [语言] 语法高亮）。
+3. 如存在争议点，列出不同观点并注明“无共识”。
+**输出格式**：Markdown 层级标题，必要时插入表格/列表。
+**约束**：避免空洞词汇（如“细致入微”“深入探究”）；每段都应有实质信息；保持原意，不添加原文没有的事实。
+**验证**：请先提供大纲，经我确认后再扩展。
+```
+
+### ⚡ 精简版模板
+```text
+Document [模块/API] for [目标读者].
+Structure: overview → quickstart → API reference → ≥2 real examples.
+Ensure code examples are runnable. Output Markdown.
+```
+
+### 🔑 关键提示
+- 明确 **目标受众** 和 **输出格式**，让文档可落地。
+- 要求 **先出大纲**，避免一次性生成冗长且离题的内容。
+- 强调 **示例可运行**，提升文档的实用性。
+
+---
+
+## 4. `refactor` — 重构 / 优化现有结构
+
+> 核心口诀：**手术式修改，行为不变**  
+> 适合场景：改进代码结构、拆分模块、改善可读性/可维护性
+
+### 📝 详细版模板
+```text
+[refactor] 对 @file:[文件路径]（约 [行数] 行）进行重构，提升 [可读性 / 可维护性]
+
+**背景**：当前代码存在 [具体问题，如重复逻辑、耦合度高]。
+**任务**：
+1. 识别 3 个主要问题。
+2. 提出重构方案，说明改动前后差异。
+3. 输出重构后的完整版本。
+**硬性约束**：
+- 不改变任何行为，保留所有公共 API 签名不变。
+- 禁止顺手优化、禁止添加新功能、禁止修改业务逻辑。
+- 拆分后运行 [测试命令] 确认无回归。
+**输出**：提供 diff 和新模块的依赖关系图。
+**验证**：运行 [测试命令] 并确保全部通过。
+```
+
+### ⚡ 精简版模板
+```text
+Surgical changes only.
+Refactor @file:[路径] — [目标]。
+Zero behavior change. Keep all public API signatures.
+Run [测试命令] after. No optimization.
+```
+
+### 🔑 关键提示
+- 遵循 **Andrej Karpathy 的 “Surgical Changes”** 原则，只改必须改的地方。
+- 明确“**不改变任何行为**”并用测试证明，是区分熟练使用者和新手的关键习惯。
+
+---
+
+## 5. `test` — 测试用例 / 评估
+
+> 核心口诀：**表驱动，先红后绿**  
+> 适合场景：生成测试数据、编写单元/集成测试、设计验证标准
+
+### 📝 详细版模板
+```text
+[test] 为 @file:[文件路径] 中的变更生成表驱动测试
+
+**角色**：你是一个资深测试工程师。
+**背景**：使用 [Jest / Vitest / pytest] 框架，追求 ≥[90]% 分支覆盖率。
+**任务**：
+1. 覆盖维度：null 值、空值、超时、幂等性、重试、成功路径、4xx/5xx 错误、边界条件 [列举具体边界]。
+2. 优先让测试先失败（红），再提供补丁使其通过（绿）。
+**输出格式**：表格列出场景 → 预期结果 → 权重，末尾附评分模板。
+**约束**：评分准则必须无歧义；不要假设输入总是合法的。
+**验证**：运行 [测试命令] 并展示覆盖率报告。
+```
+
+### ⚡ 精简版模板
+```text
+Table-driven tests for @file:[路径].
+Cover: nulls, timeouts, idempotency, edge cases.
+Fail first, then pass. Use [框架]. Target ≥[90]% coverage.
+```
+
+### 🔑 关键提示
+- **表驱动测试**（Table-Driven Tests）能覆盖更多边界条件。
+- **先红后绿**（让测试先失败再通过）是验证测试有效性的最佳方式。
+
+---
+
+## 6. `chore` — 日常维护 / 杂项自动化
+
+> 核心口诀：**只做必须，禁止顺手**  
+> 适合场景：依赖更新、构建配置、CI 调整、批量重命名、环境配置
+
+### 📝 详细版模板
+```text
+[chore] 在 @file:[配置文件路径] 中 [更新依赖 / 修改构建脚本 / 调整 CI]
+
+**角色**：你是一个 DevOps 工程师。
+**背景**：当前环境 [描述]，目标版本 [版本号]。
+**任务**：
+1. 只做 [具体任务]，不做任何其他改动。
+2. 改动后运行 [验证命令] 确认无破坏性变更。
+**硬性约束**：
+- NEVER 修改生产环境配置文件（如 config/production.yml）。
+- NEVER 运行任何部署命令（除非用户明确要求）。
+- 禁止顺手升级无关依赖、禁止修改代码逻辑。
+**输出**：提供变更前后对比和影响说明。
+**验证**：运行 [验证命令] 并展示结果。
+```
+
+### ⚡ 精简版模板
+```text
+Only [具体任务] — no other changes.
+@file:[路径] — [操作描述]。
+NEVER touch production configs.
+Run [验证命令] after.
+```
+
+### 🔑 关键提示
+- 使用 **NEVER + 明确豁免条件** 来锁死危险行为，比“尽量不要”有效得多。
+- 明确 **“只做必须的”**，防止 AI 在杂务中顺手“优化”导致 CI 崩溃。
+
+---
+
+## 7. `perf` — 性能优化
+
+> 核心口诀：**先测量，后优化**  
+> 适合场景：查询优化、缓存策略、算法改进、减少 token 消耗
+
+### 📝 详细版模板
+```text
+[perf] 优化 @file:[文件路径] 中的 [瓶颈描述]
+
+**角色**：你是一位性能优化专家。
+**背景**：当前执行耗时约 [X 秒] / 成本约 $Y，用户可接受的延迟为 [Z ms]。
+**任务**：
+1. Think deeply about this performance issue.
+2. 先分析当前性能数据，给出基准指标。
+3. 列出 ≥2 种优化方案，分析每个方案的预估提升幅度、实现复杂度、潜在风险。
+4. 选择推荐方案并实现。优化后运行 [基准测试命令] 对比前后数据。
+**输出**：提供 before/after 性能对比表格。
+**约束**：不要牺牲核心准确性；优先给出低风险改动；不为了微优化牺牲可读性。
+```
+
+### ⚡ 精简版模板
+```text
+Think deeply.
+Optimize @file:[路径] — [瓶颈]。
+≥2 approaches with trade-offs. Benchmark before & after.
+```
+
+### 🔑 关键提示
+- **“Think deeply”** 能触发 AI 的权衡分析，避免表面答案。
+- **必须提供基准对比**，数据驱动决策，拒绝凭感觉优化。
+
+---
+
+## 8. `style` — 风格 / 格式调整
+
+> 核心口诀：**保持原意，统一规范**  
+> 适合场景：改写语气、统一术语、格式化代码、调整注释风格
+
+### 📝 详细版模板
+```text
+[style] 将以下 [代码/文本] 调整为 [正式商务 / 幽默 / 简洁要点式 / Prettier 规范]
+
+**原文**：[粘贴内容]
+**任务**：
+1. 保持原意和信息完整，仅改变表达风格 / 代码格式。
+2. 术语统一为 [术语表，可选]。
+3. 输出两种备选风格供我对比。
+**约束**：不要添加原文没有的新事实，不要改变关键数据和逻辑；同时指出原文中可能存在的歧义表达。
+**验证**：对代码运行 [linter / formatter 检查命令] 确保符合规范。
+```
+
+### ⚡ 精简版模板
+```text
+Reformat [代码/文本] to [风格]。
+Keep original meaning. Provide 2 style options for comparison.
+Run [linter] after if code.
+```
+
+### 🔑 关键提示
+- 明确 **风格目标** 和 **术语表**，避免 AI 自由发挥。
+- 对代码风格调整，务必配合 **自动化格式化工具** 验证。
+
+---
+
+## 🛡️ 补充类型
+
+| 类型       | 用途     | 核心口诀               | 示例场景                               |
+| ---------- | -------- | ---------------------- | -------------------------------------- |
+| `security` | 安全审查 | 独立审查，逐项排查     | 检查代码漏洞、提示词注入风险、密钥泄露 |
+| `explain`  | 概念解释 | 类比引导，由浅入深     | 向小白讲解复杂原理                     |
+| `compare`  | 对比评估 | 多维矩阵，客观打分     | 多产品/多方案的优劣势分析              |
+| `forecast` | 预测趋势 | 数据驱动，标明不确定性 | 基于数据预测未来走向                   |
+
+### `security` 详细模板
+```text
+[security] 对 @file:[文件路径] 运行安全审查
+
+**角色**：你是一名安全审计专家（独立于编写代码的 Agent）。
+**任务**：
+1. 审查清单：认证边界、注入漏洞、敏感数据暴露、CSRF/CORS 配置、权限校验缺失。
+2. 提供带行号的修复方案及理由。
+3. 只审查不修改，输出审查报告。
+**硬性约束**：在隔离上下文中运行，不继承主 Agent 的记忆。
+**输出**：Markdown 报告，每个问题包含严重级别、行号、风险描述、修复建议。
+```
+
+---
+
+## 🧪 使用建议（融合最佳实践）
+
+1. **启动新话题** — 清空无关上下文，每次新会话用 `Resume project X` 恢复状态（依赖 SESSION.md）。  
+2. **Plan 先行** — 对复杂任务（涉及 >2 个文件），先让 AI 输出计划，Review 后再编码。  
+3. **对抗谄媚** — 在约束中写明：“请客观评价，不要只说优点。若有不足，请明确指出。”  
+4. **渐进迭代** — 先让 AI 输出大纲/问题列表，反馈确认后再生成最终结果。  
+5. **多模型验证** — 将同一提示词发给 ChatGPT、Claude、Gemini，选出最佳输出。  
+6. **持久化规则** — 将团队规范、构建命令、常见陷阱写入 `CLAUDE.md` 或 `AGENTS.md`，每次会话自动加载。  
+7. **新会话 = 新开始** — 避免超长对话，上下文压缩风险在新会话中降至零。
+
+---
+
+> 💡 **核心原则**：上下文精准 · 验证驱动 · 极简主义 · Plan 先行 · 硬性约束 · 深度思考  
+> 模板中的 `[ ]` 为必填占位符，直接替换即可使用。

package/extensions/dev-prompts.ts

@@ -0,0 +1,570 @@
+/**
+ * Dev Prompts Extension
+ *
+ * Registers /dev-* commands that interactively collect missing context for
+ * high-quality prompt templates (from ai提示词优化.md) and send the assembled
+ * prompt directly to the main agent.
+ *
+ * Commands:
+ *   /dev-feat       - New feature / creative generation
+ *   /dev-fix         - Bug fix / error troubleshooting
+ *   /dev-doc         - Documentation generation
+ *   /dev-refactor    - Code refactoring
+ *   /dev-test        - Test case generation
+ *   /dev-chore       - Maintenance / automation
+ *   /dev-perf        - Performance optimization
+ *   /dev-style       - Style / format adjustment
+ *   /dev-security    - Security review
+ *   /dev-explain     - Concept explanation
+ *   /dev-compare     - Comparison evaluation
+ *
+ * Usage: type /dev-<type> and follow the wizard.
+ * Leave a field empty (Enter) to skip its section.
+ * Press Esc to cancel the entire wizard.
+ */
+
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+
+// ── Helpers ──────────────────────────────────────────────────
+
+/** Ask a single question. Returns `undefined` on cancel (Esc). */
+async function ask(
+	ctx: ExtensionCommandContext,
+	label: string,
+	placeholder: string,
+): Promise<string | undefined> {
+	return ctx.ui.input(label, { placeholder, required: false });
+}
+
+/** Check if a field value is empty or explicitly "无". */
+function isEmpty(val: string | undefined): boolean {
+	return !val || val.trim() === "" || val.trim() === "无";
+}
+
+/** Wrap a non-empty value for template insertion. */
+function wrap(val: string | undefined, fallback = "..."): string {
+	if (isEmpty(val)) return fallback;
+	return val!.trim();
+}
+
+// ── Template Assemblers ──────────────────────────────────────
+
+interface FeatFields {
+	language: string;
+	techStack: string;
+	module: string;
+	description: string;
+	painPoint: string;
+	testCmd: string;
+}
+
+function assembleFeatPrompt(f: FeatFields): string {
+	const lines: string[] = [];
+	lines.push(`[feat] 在 ${wrap(f.module)} 中实现 ${wrap(f.description)}`);
+	lines.push("");
+	lines.push(`**角色**：你是一个资深 ${wrap(f.language)} 工程师。`);
+	if (!isEmpty(f.techStack) || !isEmpty(f.painPoint)) {
+		lines.push(
+			`**背景**：项目使用 ${wrap(f.techStack)}，当前缺少 ${wrap(f.description)}` +
+			(isEmpty(f.painPoint) ? "。" : `，用户痛点是 ${f.painPoint!.trim()}。`),
+		);
+	}
+	lines.push("**任务**：");
+	lines.push("1. 先分析代码库结构，给出逐步实施计划（列出要修改/创建的文件、数据库迁移、对现有代码的假设）。");
+	lines.push("2. 计划经我确认后再编写代码。");
+	if (!isEmpty(f.testCmd)) {
+		lines.push(`3. 实现后编写测试用例验证核心逻辑，并运行 ${f.testCmd!.trim()} 确认通过。`);
+	} else {
+		lines.push("3. 实现后编写测试用例验证核心逻辑。");
+	}
+	lines.push("**输出**：提供 unified diff 和两句话的变更说明。");
+	lines.push("**约束**：禁止顺手重构无关代码；保持所有公共 API 签名兼容；不要为假设性需求添加抽象层。");
+	if (!isEmpty(f.testCmd)) {
+		lines.push(`**验证**：运行 ${f.testCmd!.trim()} 确保无回归。`);
+	}
+	return lines.join("\n");
+}
+
+interface FixFields {
+	filePath: string;
+	lineNumber: string;
+	bugDesc: string;
+	inputDesc: string;
+	expected: string;
+	actualError: string;
+	testCmd: string;
+}
+
+function assembleFixPrompt(f: FixFields): string {
+	const lines: string[] = [];
+	const loc = isEmpty(f.lineNumber) ? f.filePath.trim() : `${f.filePath.trim()} #L${f.lineNumber!.trim()}`;
+	lines.push(`[fix] 修复 ${loc} 中的 ${wrap(f.bugDesc)}`);
+	lines.push("");
+	lines.push("**背景**：");
+	lines.push(`- 输入：${isEmpty(f.inputDesc) ? "见代码上下文" : f.inputDesc!.trim()}`);
+	lines.push(`- 预期行为：${wrap(f.expected, "请描述预期结果")}`);
+	lines.push(`- 当前错误：${wrap(f.actualError, "请描述当前错误")}`);
+	lines.push("**任务**：");
+	lines.push("1. 不要仅仅消除报错（Suppress），要解决根本原因。");
+	lines.push("2. 先读取相关代码和日志，诊断根因（多步推理，不要先给结论）。");
+	lines.push("3. 提供至少一种修复方案，并说明为什么这样做。");
+	lines.push("4. 编写测试用例复现该 Bug 并确认修复有效。");
+	lines.push("**输出**：提供 diff 和两句话的根因分析。");
+	lines.push("**约束**：只修 bug，不做重构；最小化改动；不要假设错误是微不足道的。");
+	if (!isEmpty(f.testCmd)) {
+		lines.push(`**验证**：运行 ${f.testCmd!.trim()} 确认修复。`);
+	}
+	return lines.join("\n");
+}
+
+interface DocFields {
+	moduleName: string;
+	audience: string;
+	keyInfo: string;
+	language: string;
+	existingMaterial: string;
+}
+
+function assembleDocPrompt(f: DocFields): string {
+	const lines: string[] = [];
+	lines.push(`[doc] 为 ${wrap(f.moduleName)} 撰写一份文档`);
+	lines.push("");
+	lines.push("**角色**：你是一位技术文档工程师。");
+	if (!isEmpty(f.audience) || !isEmpty(f.keyInfo)) {
+		lines.push(`**背景**：目标受众是 ${wrap(f.audience)}，他们需要了解 ${wrap(f.keyInfo)}。`);
+	}
+	lines.push("**任务**：");
+	lines.push("1. 提取核心要点，按逻辑结构重组（概述 → 快速开始 → 详细说明 → 常见问题）。");
+	lines.push(`2. 添加至少 2 个真实可运行的示例（使用 ${wrap(f.language)} 语法高亮）。`);
+	lines.push("3. 如存在争议点，列出不同观点并注明\"无共识\"。");
+	if (!isEmpty(f.existingMaterial)) {
+		lines.push(`**已有材料**：${f.existingMaterial!.trim()}`);
+	}
+	lines.push("**输出格式**：Markdown 层级标题，必要时插入表格/列表。");
+	lines.push("**约束**：避免空洞词汇（如\"细致入微\"\"深入探究\"）；每段都应有实质信息；保持原意，不添加原文没有的事实。");
+	lines.push("**验证**：请先提供大纲，经我确认后再扩展。");
+	return lines.join("\n");
+}
+
+interface RefactorFields {
+	filePath: string;
+	lineCount: string;
+	problems: string;
+	goal: string;
+	testCmd: string;
+}
+
+function assembleRefactorPrompt(f: RefactorFields): string {
+	const lines: string[] = [];
+	const loc = isEmpty(f.lineCount) ? f.filePath.trim() : `${f.filePath.trim()}（约 ${f.lineCount!.trim()} 行）`;
+	lines.push(`[refactor] 对 ${loc} 进行重构，提升 ${wrap(f.goal, "可读性 / 可维护性")}`);
+	lines.push("");
+	lines.push(`**背景**：当前代码存在 ${wrap(f.problems)}。`);
+	lines.push("**任务**：");
+	lines.push("1. 识别 3 个主要问题。");
+	lines.push("2. 提出重构方案，说明改动前后差异。");
+	lines.push("3. 输出重构后的完整版本。");
+	lines.push("**硬性约束**：");
+	lines.push("- 不改变任何行为，保留所有公共 API 签名不变。");
+	lines.push("- 禁止顺手优化、禁止添加新功能、禁止修改业务逻辑。");
+	if (!isEmpty(f.testCmd)) {
+		lines.push(`- 拆分后运行 ${f.testCmd!.trim()} 确认无回归。`);
+	}
+	lines.push("**输出**：提供 diff 和新模块的依赖关系图。");
+	if (!isEmpty(f.testCmd)) {
+		lines.push(`**验证**：运行 ${f.testCmd!.trim()} 并确保全部通过。`);
+	}
+	return lines.join("\n");
+}
+
+interface TestFields {
+	filePath: string;
+	framework: string;
+	coverage: string;
+	edgeCases: string;
+	testCmd: string;
+}
+
+function assembleTestPrompt(f: TestFields): string {
+	const lines: string[] = [];
+	lines.push(`[test] 为 ${wrap(f.filePath)} 中的变更生成表驱动测试`);
+	lines.push("");
+	lines.push(`**角色**：你是一个资深测试工程师。`);
+	lines.push(`**背景**：使用 ${wrap(f.framework)} 框架，追求 ≥${wrap(f.coverage, "90")}% 分支覆盖率。`);
+	lines.push("**任务**：");
+	lines.push(`1. 覆盖维度：${isEmpty(f.edgeCases) ? "null 值、空值、超时、幂等性、重试、成功路径、4xx/5xx 错误、边界条件" : f.edgeCases!.trim()}。`);
+	lines.push("2. 优先让测试先失败（红），再提供补丁使其通过（绿）。");
+	lines.push("**输出格式**：表格列出场景 → 预期结果 → 权重，末尾附评分模板。");
+	lines.push("**约束**：评分准则必须无歧义；不要假设输入总是合法的。");
+	if (!isEmpty(f.testCmd)) {
+		lines.push(`**验证**：运行 ${f.testCmd!.trim()} 并展示覆盖率报告。`);
+	}
+	return lines.join("\n");
+}
+
+interface ChoreFields {
+	configPath: string;
+	task: string;
+	envDesc: string;
+	targetVersion: string;
+	verifyCmd: string;
+}
+
+function assembleChorePrompt(f: ChoreFields): string {
+	const lines: string[] = [];
+	lines.push(`[chore] 在 ${wrap(f.configPath)} 中 ${wrap(f.task)}`);
+	lines.push("");
+	lines.push("**角色**：你是一个 DevOps 工程师。");
+	lines.push(`**背景**：当前环境 ${wrap(f.envDesc)}，目标版本 ${wrap(f.targetVersion)}。`);
+	lines.push("**任务**：");
+	lines.push(`1. 只做 ${wrap(f.task)}，不做任何其他改动。`);
+	if (!isEmpty(f.verifyCmd)) {
+		lines.push(`2. 改动后运行 ${f.verifyCmd!.trim()} 确认无破坏性变更。`);
+	}
+	lines.push("**硬性约束**：");
+	lines.push("- NEVER 修改生产环境配置文件（如 config/production.yml）。");
+	lines.push("- NEVER 运行任何部署命令（除非用户明确要求）。");
+	lines.push("- 禁止顺手升级无关依赖、禁止修改代码逻辑。");
+	lines.push("**输出**：提供变更前后对比和影响说明。");
+	if (!isEmpty(f.verifyCmd)) {
+		lines.push(`**验证**：运行 ${f.verifyCmd!.trim()} 并展示结果。`);
+	}
+	return lines.join("\n");
+}
+
+interface PerfFields {
+	filePath: string;
+	bottleneck: string;
+	currentCost: string;
+	targetLatency: string;
+	benchCmd: string;
+}
+
+function assemblePerfPrompt(f: PerfFields): string {
+	const lines: string[] = [];
+	lines.push(`[perf] 优化 ${wrap(f.filePath)} 中的 ${wrap(f.bottleneck)}`);
+	lines.push("");
+	lines.push("**角色**：你是一位性能优化专家。");
+	lines.push(`**背景**：当前执行耗时约 ${wrap(f.currentCost)}，用户可接受的延迟为 ${wrap(f.targetLatency)}。`);
+	lines.push("**任务**：");
+	lines.push("1. Think deeply about this performance issue.");
+	lines.push("2. 先分析当前性能数据，给出基准指标。");
+	lines.push("3. 列出 ≥2 种优化方案，分析每个方案的预估提升幅度、实现复杂度、潜在风险。");
+	if (!isEmpty(f.benchCmd)) {
+		lines.push(`4. 选择推荐方案并实现。优化后运行 ${f.benchCmd!.trim()} 对比前后数据。`);
+	} else {
+		lines.push("4. 选择推荐方案并实现。优化后运行基准测试对比前后数据。");
+	}
+	lines.push("**输出**：提供 before/after 性能对比表格。");
+	lines.push("**约束**：不要牺牲核心准确性；优先给出低风险改动；不为了微优化牺牲可读性。");
+	return lines.join("\n");
+}
+
+interface StyleFields {
+	targetStyle: string;
+	description: string;
+	terms: string;
+	lintCmd: string;
+}
+
+function assembleStylePrompt(f: StyleFields): string {
+	const lines: string[] = [];
+	lines.push(`[style] 将以下内容调整为 ${wrap(f.targetStyle)}`);
+	lines.push("");
+	lines.push("**角色**：你是一个代码风格专家。");
+	lines.push(`**原文**：${wrap(f.description, "（见当前上下文）")}`);
+	lines.push("**任务**：");
+	lines.push("1. 保持原意和信息完整，仅改变表达风格/代码格式。");
+	if (!isEmpty(f.terms)) {
+		lines.push(`2. 术语统一为：${f.terms!.trim()}。`);
+		lines.push("3. 输出两种备选风格供我对比。");
+	} else {
+		lines.push("2. 输出两种备选风格供我对比。");
+	}
+	lines.push("**约束**：不要添加原文没有的新事实，不要改变关键数据和逻辑；同时指出原文中可能存在的歧义表达。");
+	if (!isEmpty(f.lintCmd)) {
+		lines.push(`**验证**：对代码运行 ${f.lintCmd!.trim()} 确保符合规范。`);
+	}
+	return lines.join("\n");
+}
+
+interface SecurityFields {
+	filePath: string;
+	focus: string;
+}
+
+function assembleSecurityPrompt(f: SecurityFields): string {
+	const lines: string[] = [];
+	lines.push(`[security] 对 ${wrap(f.filePath)} 运行安全审查`);
+	lines.push("");
+	lines.push("**角色**：你是一名安全审计专家（独立于编写代码的 Agent）。");
+	lines.push("**任务**：");
+	lines.push(`1. 审查清单：${isEmpty(f.focus) ? "认证边界、注入漏洞、敏感数据暴露、CSRF/CORS 配置、权限校验缺失" : f.focus!.trim()}。`);
+	lines.push("2. 提供带行号的修复方案及理由。");
+	lines.push("3. 只审查不修改，输出审查报告。");
+	lines.push("**硬性约束**：在隔离上下文中运行，不继承主 Agent 的记忆。");
+	lines.push("**输出**：Markdown 报告，每个问题包含严重级别、行号、风险描述、修复建议。");
+	return lines.join("\n");
+}
+
+interface ExplainFields {
+	concept: string;
+	audience: string;
+	depth: string;
+}
+
+function assembleExplainPrompt(f: ExplainFields): string {
+	const lines: string[] = [];
+	lines.push(`[explain] 解释 ${wrap(f.concept)}`);
+	lines.push("");
+	lines.push("**角色**：你是一位资深技术导师，擅长用类比引导初学者理解复杂概念。");
+	lines.push(`**背景**：目标受众是 ${wrap(f.audience)}，需要理解 ${wrap(f.concept)} 的 ${wrap(f.depth, "基础")} 层面。`);
+	lines.push("**任务**：");
+	lines.push("1. 用生活化的类比引入概念，建立直觉。");
+	lines.push("2. 由浅入深逐步展开，先给大局观再进入细节。");
+	lines.push("3. 提供至少一个真实世界的应用场景。");
+	lines.push("4. 如有常见误区，明确指出。");
+	lines.push("**输出格式**：Markdown，必要时插入图示描述。");
+	lines.push("**验证**：请先给出一句话总结，经我确认后再展开。");
+	return lines.join("\n");
+}
+
+interface CompareFields {
+	itemA: string;
+	itemB: string;
+	dimensions: string;
+}
+
+function assembleComparePrompt(f: CompareFields): string {
+	const lines: string[] = [];
+	lines.push(`[compare] 对比 ${wrap(f.itemA)} 与 ${wrap(f.itemB)}`);
+	lines.push("");
+	lines.push("**角色**：你是一位客观中立的评测专家。");
+	lines.push(`**背景**：需要从 ${wrap(f.dimensions, "多个方面")} 对 ${wrap(f.itemA)} 和 ${wrap(f.itemB)} 进行全面对比。`);
+	lines.push("**任务**：");
+	lines.push("1. 构建多维度评估矩阵，量化或半量化评分。");
+	lines.push("2. 分析各维度的权衡（Trade-offs），说明在什么场景下哪个更优。");
+	lines.push("3. 给出综合结论和建议。");
+	lines.push("**输出格式**：Markdown 表格 + 简短分析。");
+	lines.push("**约束**：客观中立，不偏袒任何一方，明确标注不确定的结论。");
+	return lines.join("\n");
+}
+
+// ── Command runner ───────────────────────────────────────────
+
+/**
+ * Run a wizard: ask questions, assemble prompt, send to agent.
+ * @param ctx     Command context
+ * @param pi      Extension API (for sendUserMessage)
+ * @param type    Display name of the prompt type (e.g. "feat")
+ * @param label   Friendly label (e.g. "新功能/创意生成")
+ * @param questions  Array of [label, placeholder] pairs
+ * @param assembler  Function that takes answers and returns the prompt string
+ */
+async function runWizard(
+	ctx: ExtensionCommandContext,
+	pi: ExtensionAPI,
+	type: string,
+	label: string,
+	questions: Array<{ label: string; placeholder: string; key: string }>,
+	assembler: (answers: Record<string, string>) => string,
+): Promise<void> {
+	ctx.ui.notify(`📋 /dev-${type} — ${label}，请逐项填写以下信息（留空跳过对应段落，Esc 取消）`, "info");
+
+	const answers: Record<string, string> = {};
+
+	for (const q of questions) {
+		const val = await ask(ctx, q.label, q.placeholder);
+		if (val === undefined) {
+			ctx.ui.notify("❌ 已取消", "warning");
+			return;
+		}
+		answers[q.key] = val;
+	}
+
+	const prompt = assembler(answers);
+	ctx.ui.notify(`✅ 提示词已组装完成，正在发送给主代理...`, "success");
+
+	// Send the assembled prompt to the main agent
+	pi.sendUserMessage(prompt);
+
+	// Also show the prompt in a notification for reference
+	ctx.ui.notify(`📝 /dev-${type} 提示词已投递，主代理正在处理`, "info");
+}
+
+// ── Questions for each command ────────────────────────────────
+
+const FEAT_QUESTIONS = [
+	{ label: "编程语言/框架", placeholder: "如 TypeScript, Python, Rust...", key: "language" },
+	{ label: "技术栈", placeholder: "如 NestJS + Prisma, React + Express...", key: "techStack" },
+	{ label: "目标模块/文件名", placeholder: "如 src/auth/login.ts", key: "module" },
+	{ label: "核心功能描述", placeholder: "用户可以通过邮箱+密码注册并登录", key: "description" },
+	{ label: "用户痛点/当前缺少", placeholder: "当前缺少用户认证系统，每次手动校验身份", key: "painPoint" },
+	{ label: "测试命令（可选）", placeholder: "如 npm test, cargo test, go test...", key: "testCmd" },
+];
+
+const FIX_QUESTIONS = [
+	{ label: "文件路径", placeholder: "如 src/auth/login.ts", key: "filePath" },
+	{ label: "行号（可选）", placeholder: "如 42，留空则扫描整个文件", key: "lineNumber" },
+	{ label: "Bug 描述", placeholder: "登录接口在密码正确时返回 401", key: "bugDesc" },
+	{ label: "输入/现象", placeholder: "输入正确邮箱和密码，返回 401 错误", key: "inputDesc" },
+	{ label: "预期行为", placeholder: "应返回 200 和 token", key: "expected" },
+	{ label: "当前错误信息", placeholder: "Unauthorized (401) - 不符合预期的输出", key: "actualError" },
+	{ label: "测试命令（可选）", placeholder: "如 npm test, go test...", key: "testCmd" },
+];
+
+const DOC_QUESTIONS = [
+	{ label: "模块/API 名称", placeholder: "如 AuthService, REST API v2...", key: "moduleName" },
+	{ label: "目标受众", placeholder: "如 小白 / 前端开发者 / 架构师", key: "audience" },
+	{ label: "关键信息点", placeholder: "他们需要了解如何使用认证接口", key: "keyInfo" },
+	{ label: "示例语言", placeholder: "如 TypeScript, Python, curl...", key: "language" },
+	{ label: "已有材料（可选）", placeholder: "现有 README、笔记、文件路径等，留空则从零生成", key: "existingMaterial" },
+];
+
+const REFACTOR_QUESTIONS = [
+	{ label: "文件路径", placeholder: "如 src/auth/login.ts", key: "filePath" },
+	{ label: "代码行数（可选）", placeholder: "如 200 行", key: "lineCount" },
+	{ label: "具体问题", placeholder: "如 重复逻辑、耦合度高、可读性差", key: "problems" },
+	{ label: "重构目标", placeholder: "如 可读性 / 可维护性 / 模块化", key: "goal" },
+	{ label: "测试命令（可选）", placeholder: "如 npm test, cargo test...", key: "testCmd" },
+];
+
+const TEST_QUESTIONS = [
+	{ label: "文件路径", placeholder: "如 src/auth/login.ts", key: "filePath" },
+	{ label: "测试框架", placeholder: "如 Jest / Vitest / pytest / Go test", key: "framework" },
+	{ label: "目标覆盖率", placeholder: "如 90，留空默认 90%", key: "coverage" },
+	{ label: "边界条件", placeholder: "如 null 值、空值、超时、幂等性、4xx/5xx 错误", key: "edgeCases" },
+	{ label: "测试命令（可选）", placeholder: "如 npm test -- --coverage", key: "testCmd" },
+];
+
+const CHORE_QUESTIONS = [
+	{ label: "配置文件/目标路径", placeholder: "如 package.json, .github/workflows/ci.yml", key: "configPath" },
+	{ label: "具体任务", placeholder: "如 更新依赖、修改构建脚本、调整 CI 配置", key: "task" },
+	{ label: "当前环境描述", placeholder: "如 Node 18, pnpm 8", key: "envDesc" },
+	{ label: "目标版本", placeholder: "如 Node 20, pnpm 9", key: "targetVersion" },
+	{ label: "验证命令（可选）", placeholder: "如 npm run build, pnpm test...", key: "verifyCmd" },
+];
+
+const PERF_QUESTIONS = [
+	{ label: "文件路径", placeholder: "如 src/services/query.ts", key: "filePath" },
+	{ label: "瓶颈描述", placeholder: "如 数据库查询延迟过高、内存泄漏", key: "bottleneck" },
+	{ label: "当前执行耗时", placeholder: "如 5 秒 / 成本 $0.02/次", key: "currentCost" },
+	{ label: "目标延迟", placeholder: "如 200ms", key: "targetLatency" },
+	{ label: "基准测试命令（可选）", placeholder: "如 npm run bench, go test -bench=.", key: "benchCmd" },
+];
+
+const STYLE_QUESTIONS = [
+	{ label: "目标风格", placeholder: "如 正式商务 / 幽默 / 简洁要点式 / Prettier 规范", key: "targetStyle" },
+	{ label: "待调整内容描述", placeholder: "如 以下函数需要调整命名风格，或粘贴文本", key: "description" },
+	{ label: "术语统一（可选）", placeholder: "如 API → 接口, user → 用户", key: "terms" },
+	{ label: "Linter/格式化命令（可选）", placeholder: "如 npx prettier --check, npm run lint", key: "lintCmd" },
+];
+
+const SECURITY_QUESTIONS = [
+	{ label: "文件路径", placeholder: "如 src/api/auth.ts", key: "filePath" },
+	{ label: "审查重点（可选）", placeholder: "如 认证边界、注入漏洞、敏感数据暴露、CSRF/CORS、权限校验", key: "focus" },
+];
+
+const EXPLAIN_QUESTIONS = [
+	{ label: "概念名称", placeholder: "如 React Server Component, HTTP/3", key: "concept" },
+	{ label: "目标受众", placeholder: "如 小白 / 开发者 / 架构师", key: "audience" },
+	{ label: "理解深度（可选）", placeholder: "如 基础 / 进阶，留空默认基础", key: "depth" },
+];
+
+const COMPARE_QUESTIONS = [
+	{ label: "对比对象 A", placeholder: "如 Vue 3, Next.js, PostgreSQL...", key: "itemA" },
+	{ label: "对比对象 B", placeholder: "如 React 18, Nuxt 3, MySQL...", key: "itemB" },
+	{ label: "评估维度（可选）", placeholder: "如 性能、生态、学习曲线、社区支持", key: "dimensions" },
+];
+
+// ── Extension ────────────────────────────────────────────────
+
+export default function (pi: ExtensionAPI) {
+	// ── /dev-feat ──────────────────────────────────────────────
+	pi.registerCommand("dev-feat", {
+		description: "(prompt wizard) 新功能/创意生成 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "feat", "新功能/创意生成", FEAT_QUESTIONS, assembleFeatPrompt);
+		},
+	});
+
+	// ── /dev-fix ───────────────────────────────────────────────
+	pi.registerCommand("dev-fix", {
+		description: "(prompt wizard) 问题排查/错误修正 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "fix", "问题排查/错误修正", FIX_QUESTIONS, assembleFixPrompt);
+		},
+	});
+
+	// ── /dev-doc ───────────────────────────────────────────────
+	pi.registerCommand("dev-doc", {
+		description: "(prompt wizard) 文档生成/总结 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "doc", "文档生成/总结", DOC_QUESTIONS, assembleDocPrompt);
+		},
+	});
+
+	// ── /dev-refactor ──────────────────────────────────────────
+	pi.registerCommand("dev-refactor", {
+		description: "(prompt wizard) 重构/优化现有结构 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "refactor", "重构/优化", REFACTOR_QUESTIONS, assembleRefactorPrompt);
+		},
+	});
+
+	// ── /dev-test ──────────────────────────────────────────────
+	pi.registerCommand("dev-test", {
+		description: "(prompt wizard) 测试用例生成 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "test", "测试用例/评估", TEST_QUESTIONS, assembleTestPrompt);
+		},
+	});
+
+	// ── /dev-chore ─────────────────────────────────────────────
+	pi.registerCommand("dev-chore", {
+		description: "(prompt wizard) 日常维护/杂项自动化 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "chore", "日常维护/自动化", CHORE_QUESTIONS, assembleChorePrompt);
+		},
+	});
+
+	// ── /dev-perf ──────────────────────────────────────────────
+	pi.registerCommand("dev-perf", {
+		description: "(prompt wizard) 性能优化 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "perf", "性能优化", PERF_QUESTIONS, assemblePerfPrompt);
+		},
+	});
+
+	// ── /dev-style ─────────────────────────────────────────────
+	pi.registerCommand("dev-style", {
+		description: "(prompt wizard) 风格/格式调整 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "style", "风格/格式调整", STYLE_QUESTIONS, assembleStylePrompt);
+		},
+	});
+
+	// ── /dev-security ──────────────────────────────────────────
+	pi.registerCommand("dev-security", {
+		description: "(prompt wizard) 安全审查 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "security", "安全审查", SECURITY_QUESTIONS, assembleSecurityPrompt);
+		},
+	});
+
+	// ── /dev-explain ───────────────────────────────────────────
+	pi.registerCommand("dev-explain", {
+		description: "(prompt wizard) 概念解释 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "explain", "概念解释", EXPLAIN_QUESTIONS, assembleExplainPrompt);
+		},
+	});
+
+	// ── /dev-compare ───────────────────────────────────────────
+	pi.registerCommand("dev-compare", {
+		description: "(prompt wizard) 对比评估 — 交互填写后发送优化提示词给主代理",
+		handler: async (args, ctx) => {
+			await runWizard(ctx, pi, "compare", "对比评估", COMPARE_QUESTIONS, assembleComparePrompt);
+		},
+	});
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghyper9023/pi-dev-workflow",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "keywords": [
     "pi-package"
   ],