@ghyper9023/pi-dev-workflow 0.7.0 → 0.8.0

package/extensions/git-commands.ts

@@ -34,7 +34,7 @@ async function runGitCommand(
 	pi: ExtensionAPI,
 	ctx: {
 		cwd: string;
-		ui: { notify: (msg: string, type: string) => void };
+		ui: { notify: (msg: string, type: "info" | "warning" | "error") => void };
 	},
 	args: string[],
 	action: string,
@@ -46,7 +46,7 @@ async function runGitCommand(
 			ctx.ui.notify(`❌ ${action} 失败 (exit ${result.code}): ${detail}`, "error");
 			return false;
 		}
-		ctx.ui.notify(`✅ ${action} 完成`, "success");
+		ctx.ui.notify(`✅ ${action} 完成`, "info");
 		return true;
 	} catch (err) {
 		ctx.ui.notify(`❌ ${action} 异常: ${err instanceof Error ? err.message : String(err)}`, "error");

package/extensions/grill-me-agent.ts

@@ -1,9 +1,13 @@
 /**
- * grill-me-agent.ts — 设计 (Grill) 和 PRD 生成的管理器（运行在当前代理中）
+ * grill-me-agent.ts — 设计追问（Grill）与 PRD 生成的运行时（运行在当前代理中）
  *
  * 职责：
- *   1. runGrillPhase()  — 由当前代理生成评审问题，TUI 逐题呈现（选项 + 自定义输入）
- *   2. runPRDPhase()    — 由当前代理生成 PRD，保存到 .pi-dev-output/pi-prd/
+ *   1. 注册 /grill 命令 — 对方案做追问式打磨，问答附到方案后交给当前代理
+ *   2. 注册 /prd 命令   — 按需求描述生成 PRD，保存到 .pi-dev-output/pi-prd/
+ *   3. runGrillPhase()  — 由当前代理生成评审问题，TUI 逐题呈现（选项 + 自定义输入）
+ *   4. runPRDPhase()    — 由当前代理生成 PRD，并询问是否立即开始开发
+ *
+ * 两个命令各自独立，不依附于 /dev-* 命令。
  *
  * 与旧版的区别：不再创建隔离的子代理进程，而是把追问/PRD 任务交给当前代理执行。
  * 当前模型普遍具备 >=1M 上下文窗口，无需通过子代理隔离上下文。
@@ -28,7 +32,7 @@ import {
 	wrapTextWithAnsi,
 	type SelectItem,
 } from "@earendil-works/pi-tui";
-import { uiSelect, uiConfirm, uiInput } from "./ui-helpers";
+import { uiSelect, uiConfirm, uiInput, uiTaskArg } from "./ui-helpers";
 import { pollFor, getLastAssistantTextAfter } from "./session-utils";
 
 // ── Types ────────────────────────────────────────────────────
@@ -103,25 +107,6 @@ export function saveAnswerFile(cwd: string, content: string): string {
 	return path.join(DEV_OUTPUT_DIR, GRILL_DIRNAME, GRILL_ANSWERS_DIRNAME, filename);
 }
 
-/**
- * Find the most recent answer backup file and read its content.
- * Returns undefined if no backup exists or read fails.
- */
-export function recoverFromBackup(cwd: string): string | undefined {
-	const dir = path.join(cwd, DEV_OUTPUT_DIR, GRILL_DIRNAME, GRILL_ANSWERS_DIRNAME);
-	try {
-		if (!fs.existsSync(dir)) return undefined;
-		const files = fs.readdirSync(dir)
-			.filter(f => f.startsWith("answer-") && f.endsWith(".md"))
-			.map(f => ({ name: f, mtime: fs.statSync(path.join(dir, f)).mtimeMs }))
-			.sort((a, b) => b.mtime - a.mtime);
-		if (files.length === 0) return undefined;
-		return fs.readFileSync(path.join(dir, files[0].name), "utf-8");
-	} catch {
-		return undefined;
-	}
-}
-
 /** Generate a safe PRD filename. */
 function generatePrdFilename(moduleSuggestion: string): string {
 	const safe = moduleSuggestion
@@ -830,12 +815,62 @@ async function askDevelopmentStart(
 	}
 }
 
-// ── Extension factory (required by pi extension loader) ─────
-//
-// This file lives in extensions/ so pi will attempt to load it.
-// The default export satisfies the loader; the real functionality
-// is consumed by dev-prompts.ts via named imports.
-//
-export default function (_pi: ExtensionAPI) {
-	// grill-me-agent is a helper module, not a standalone extension.
+// ── Extension factory ────────────────────────────────────
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("grill", {
+		description: "(grill) 提交前追问式打磨方案 — AI 逐题追问，问答附到方案后交给当前代理执行",
+		handler: async (args, ctx) => {
+			if (!ctx.hasUI) {
+				ctx.ui.notify("/grill 需要交互式界面", "error");
+				return;
+			}
+
+			const plan = await uiTaskArg(
+				ctx,
+				args,
+				"待打磨的方案 / 任务描述（必填）",
+				"如 实现邮箱密码登录：注册、登录、会话保持",
+			);
+			if (!plan) return;
+
+			const result = await runGrillPhase(plan, ctx, pi, {
+				title: "方案追问完善",
+				description: "AI 会针对方案逐题追问：术语精确化、边界条件、失败路径、验证方式。",
+				questionTitle: "方案追问完善",
+			});
+			if (result.cancelled) {
+				ctx.ui.notify("已取消追问，未发送任何内容", "info");
+				return;
+			}
+			if (result.pairs.length === 0) {
+				ctx.ui.notify("未进入追问，未发送任何内容", "info");
+				return;
+			}
+
+			saveAnswerFile(ctx.cwd, result.enhancedPrompt);
+			pi.sendUserMessage(result.enhancedPrompt, { deliverAs: "followUp" });
+			ctx.ui.notify("追问完成，方案已发送给当前代理", "info");
+		},
+	});
+
+	pi.registerCommand("prd", {
+		description: "(prd) 按需求描述生成 PRD 文档，并可选直接开始开发",
+		handler: async (args, ctx) => {
+			if (!ctx.hasUI) {
+				ctx.ui.notify("/prd 需要交互式界面", "error");
+				return;
+			}
+
+			const requirement = await uiTaskArg(
+				ctx,
+				args,
+				"PRD 需求描述（必填）",
+				"如 支持邮箱密码注册登录，含密码重置",
+			);
+			if (!requirement) return;
+
+			await runPRDPhase(requirement, requirement.split("\n")[0] || "feature", pi, ctx);
+		},
+	});
 }

package/extensions/pre-check.ts

@@ -0,0 +1,190 @@
+/**
+ * Pre-Check Extension
+ *
+ * 提供 `/dev-pre-check` 命令：在真正执行任务前插入一道「意图校验」闸门。
+ *
+ * 流程：
+ *   1. 取用户原始 prompt（命令参数，缺省则弹输入框）
+ *   2. 组合提示词 =「用户原始 prompt」+ 固定的「用自己的话重述目标与问题」指令，
+ *      并把本轮任务意图改成「只做意图理解，不产生任何实质改动」
+ *   3. 等待代理给出复述（代理空闲 + 本轮新增的 assistant 文本）
+ *   4. 用户确认意图：正确 → 开始真正的工作；不正确 → 补充说明后重新复述；取消 → 结束
+ *   5. 确认正确后，把「原始 prompt + 已确认的意图复述」投递给代理开始执行
+ *
+ * confirmIntent() 是上述 2-4 步的通用实现，/dev-feat 等 dev 命令同样复用：
+ * 它们把已确认的意图接进自己组装的提示词，而不是另造一套意图识别。
+ */
+
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { uiInput, uiSelect } from "./ui-helpers";
+import { pollFor, getLastAssistantTextAfter } from "./session-utils";
+
+// ── 提示词组装 ────────────────────────────────────────────────
+
+/** 固定的「意图复述」指令，与用户原始 prompt 组合成意图校验提示词。 */
+const RESTATE_INSTRUCTION = [
+	"## 你的任务",
+	"用自己的话重述你认为用户的目标是什么，以及用户试图解决的问题是什么。",
+	"",
+	"## 硬性约束（最高优先级）",
+	"- 本轮只做意图理解与复述，不执行任何实质工作。",
+	"- 禁止修改、创建、删除任何文件；禁止运行任何有副作用的命令。",
+	"- 禁止调用写入类工具（如 write、edit，以及 bash 中的写操作）；只允许只读探查（如 read、grep）。",
+	"- 禁止输出代码、补丁、diff、实施计划、解决方案或改进建议。",
+	"- 不要反问用户、不要请求确认、不要给出下一步行动。",
+	"- 若原始 prompt 存在歧义或信息缺口，在「不确定之处」中明确指出，但不要替用户做决定。",
+	"",
+	"## 输出格式（严格遵循）",
+	"### 1. 用户的目标",
+	"（用自己的话，2-4 句）",
+	"",
+	"### 2. 用户试图解决的问题",
+	"（用自己的话，2-4 句）",
+	"",
+	"### 3. 不确定之处",
+	"（逐条列出，无则写「无」）",
+	"",
+	"### 4. 一句话概括",
+	"（一句话说清「用户想让我做什么」）",
+	"",
+	"复述完成后立即停止，等待用户确认意图。",
+].join("\n");
+
+/** 组装意图校验提示词：原始 prompt + 固定复述指令（+ 历史修正说明）。 */
+export function buildPreCheckPrompt(originalPrompt: string, corrections: string[]): string {
+	const lines: string[] = [
+		"[pre-check] 任务意图校验：只复述，不执行",
+		"",
+		"## 用户原始 prompt（原文）",
+		originalPrompt,
+		"",
+		RESTATE_INSTRUCTION,
+	];
+
+	if (corrections.length > 0) {
+		lines.push(
+			"",
+			"## 用户对上一次复述的修正（必须吸收）",
+			...corrections.map((c, i) => `${i + 1}. ${c}`),
+		);
+	}
+
+	return lines.join("\n");
+}
+
+/** 组装确认后的执行提示词：原始 prompt + 已确认的意图复述。 */
+export function buildExecutionPrompt(originalPrompt: string, intent: string): string {
+	return [
+		"[execute] 意图已确认，开始执行",
+		"",
+		"## 用户原始 prompt（原文，权威需求）",
+		originalPrompt,
+		"",
+		"## 已由用户确认的任务意图",
+		intent,
+		"",
+		"## 要求",
+		"- 现在开始执行用户原始 prompt 描述的工作。",
+		"- 以上已确认意图是本任务的权威前提；与你的理解冲突时，以该意图为准。",
+		"- 执行前若仍需澄清，先向我提问，不要臆测。",
+	].join("\n");
+}
+
+// ── 意图确认循环 ─────────────────────────────────────────────
+
+const PRE_CHECK_TIMEOUT_MS = 5 * 60_000;
+
+/**
+ * 复述 → 确认 →（必要时）修正 的意图确认循环。
+ * 返回已确认的意图复述；用户取消或始终未取到复述时返回 undefined。
+ */
+export async function confirmIntent(
+	task: string,
+	ctx: ExtensionCommandContext,
+	pi: ExtensionAPI,
+): Promise<string | undefined> {
+	const corrections: string[] = [];
+
+	for (;;) {
+		ctx.ui.notify("正在让代理复述任务意图（只分析，不执行）...", "info");
+		const sentAt = Date.now();
+		pi.sendUserMessage(buildPreCheckPrompt(task, corrections), { deliverAs: "followUp" });
+
+		// 完成标志：代理空闲且本轮产生了新的 assistant 文本。
+		// 不依赖 waitForIdle —— 它可能在 followUp 触发的新 turn 开始前就返回。
+		const intent = await pollFor(
+			() => (ctx.isIdle() ? getLastAssistantTextAfter(ctx, sentAt) || undefined : undefined),
+			PRE_CHECK_TIMEOUT_MS,
+		);
+
+		if (!intent) {
+			const retry = await uiSelect(ctx, "未获取到代理的意图复述", ["重试", "取消"]);
+			if (retry === "重试") continue;
+			return undefined;
+		}
+
+		const decision = await uiSelect(ctx, "意图确认：以上复述是否准确反映你的目标？", [
+			"是 — 意图正确，开始执行",
+			"否 — 意图不正确，我要补充说明后重新分析",
+			"取消",
+		]);
+
+		if (!decision || decision === "取消") return undefined;
+		if (decision.startsWith("是")) return intent;
+
+		const fix = await uiInput(
+			ctx,
+			"补充/修正说明",
+			"说明哪里理解错了、遗漏了什么",
+			false,
+		);
+		if (fix === undefined) return undefined;
+		corrections.push(fix.trim() || "（用户未提供具体说明，请重新检查复述）");
+	}
+}
+
+// ── 流程 ─────────────────────────────────────────────────────
+
+async function runPreCheck(
+	pi: ExtensionAPI,
+	ctx: ExtensionCommandContext,
+	args: string,
+): Promise<void> {
+	if (!ctx.hasUI) {
+		ctx.ui.notify("/dev-pre-check 需要交互式界面才能确认意图", "error");
+		return;
+	}
+
+	let originalPrompt = args.trim();
+	if (!originalPrompt) {
+		const input = await uiInput(
+			ctx,
+			"待校验的需求（原始 prompt）",
+			"输入你希望 AI 先复述确认的需求原文",
+			true,
+		);
+		if (input === undefined) return;
+		originalPrompt = input.trim();
+		if (!originalPrompt) return;
+	}
+
+	const intent = await confirmIntent(originalPrompt, ctx, pi);
+	if (!intent) {
+		ctx.ui.notify("已取消，未执行任何改动", "info");
+		return;
+	}
+
+	pi.sendUserMessage(buildExecutionPrompt(originalPrompt, intent), { deliverAs: "followUp" });
+	ctx.ui.notify("意图已确认，开始执行", "info");
+}
+
+// ── Extension ────────────────────────────────────────────────
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("dev-pre-check", {
+		description: "(pre-check) 先让 AI 复述任务意图并确认，确认正确后再开始真正的工作",
+		handler: async (args, ctx) => {
+			await runPreCheck(pi, ctx, args);
+		},
+	});
+}

package/extensions/review-detect.ts

@@ -0,0 +1,123 @@
+/**
+ * Review Detection Extension
+ *
+ * 拦截带审查意图的输入，交给 review-html skill 在当前代理中执行：
+ *   - 直接输入 `/skill:review-html` → 立即审查
+ *   - 输入同时命中「审查意图」与「代码对象」关键词 → 弹选单让用户确认
+ *
+ * 审查报告由 review-html skill 写入 .pi-dev-output/pi-review/html/，
+ * 这里以报告文件出现作为完成标志（不使用 waitForIdle：它可能在 followUp
+ * 触发的新 turn 开始前就返回，导致误报完成）。
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { uiSelect } from "./ui-helpers";
+
+/** Find the newest HTML review file generated after `afterMs`（忽略先前遗留的旧报告）。 */
+function findNewestReviewHtml(cwd: string, afterMs: number): string {
+	const candidates = [
+		path.join(cwd, ".pi-dev-output", "pi-review", "html"),
+		path.join(cwd, "pi-review"),
+		path.join(cwd, ".pi-dev-output", "pi-review"),
+	];
+
+	for (const reviewDir of candidates) {
+		try {
+			if (fs.existsSync(reviewDir)) {
+				const files = fs.readdirSync(reviewDir)
+					.filter(f => f.endsWith(".html"))
+					.map(f => ({
+						name: f,
+						mtime: fs.statSync(path.join(reviewDir, f)).mtimeMs,
+					}))
+					.filter(f => f.mtime > afterMs)
+					.sort((a, b) => b.mtime - a.mtime);
+				if (files.length > 0) {
+					const rel = path.relative(cwd, reviewDir);
+					return rel + "/" + files[0].name;
+				}
+			}
+		} catch {
+			// ignore fs errors
+		}
+	}
+
+	return "";
+}
+
+/** Run a code review in the current agent and report the result. */
+async function runReview(task: string, ctx: ExtensionContext, pi: ExtensionAPI): Promise<string | undefined> {
+	const startTime = Date.now();
+	ctx.ui.notify("🤖 正在运行代码审查，请稍候...", "info");
+
+	pi.sendUserMessage(`/skill:review-html\n\n${task}`, {
+		deliverAs: "followUp",
+		expandPromptTemplates: true,
+	});
+
+	// 以“报告文件生成为完成标志”进行轮询；不使用 waitForIdle，
+	// 避免其在 sendUserMessage 触发的新 turn 开始前立即返回，导致误报“已完成”。
+	const deadline = Date.now() + 10 * 60_000;
+	let filePath = "";
+	while (Date.now() < deadline) {
+		filePath = findNewestReviewHtml(ctx.cwd, startTime);
+		if (filePath) break;
+		await new Promise((r) => setTimeout(r, 2_000));
+	}
+
+	const dur = ((Date.now() - startTime) / 1000).toFixed(1);
+	if (filePath) {
+		ctx.ui.notify(`📄 审查报告已生成: ${filePath} (${dur}s)`, "info");
+	} else {
+		ctx.ui.notify(`⚠️ 审查未生成报告 (${dur}s)，请查看当前代理的回复或稍后重试`, "warning");
+	}
+	return filePath;
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.on("input", async (event, ctx) => {
+		if (!ctx.hasUI) return { action: "continue" };
+		// 扩展注入的消息（sendUserMessage，source 为 "extension"）不重入本处理器，避免无限递归
+		if (event.source === "extension") return { action: "continue" };
+
+		const text = event.text.trim().toLowerCase();
+
+		// Detect review-html skill invocation or explicit review request.
+		const isReviewSkill = text.startsWith("/skill:review-html");
+		const hasReviewIntent = text.includes("review") ||
+			text.includes("审查") || text.includes("审阅") || text.includes("review-html");
+		const hasCodeTarget = text.includes("code") || text.includes("代码") ||
+			text.includes("diff") || text.includes("commit") ||
+			text.includes("html") || text.includes("report") || text.includes("报告") ||
+			text.includes("本次改动") || text.includes("这次改动");
+		const isReviewRequest = !isReviewSkill && hasReviewIntent && hasCodeTarget;
+
+		if (!isReviewSkill && !isReviewRequest) return { action: "continue" };
+
+		// ── Skill invocation: run review directly ─────────────────
+		if (isReviewSkill) {
+			await runReview(event.text, ctx, pi);
+			return { action: "handled" };
+		}
+
+		// ── Review intent: let the user choose ────────────────────
+		const mode = await uiSelect(
+			ctx,
+			"🔍 检测到审查意图",
+			[
+				"1. 开始审查（阻塞，等待结果）",
+				"2. 不是审查（放行给主代理）",
+			],
+		);
+
+		if (!mode || mode.startsWith("2")) {
+			return { action: "continue" };
+		}
+
+		await runReview(event.text, ctx, pi);
+
+		return { action: "handled" };
+	});
+}

package/extensions/session-utils.ts

@@ -98,16 +98,15 @@ export function detectProjectDefaults(cwd: string): ProjectDefaults {
 	return d;
 }
 
-/** 根据项目探测结果生成常规验收标准（测试 + lint + pre-commit + CI）。 */
-export function defaultAcceptance(d: ProjectDefaults): string {
-	const parts: string[] = [];
-	if (d.testCmd) parts.push(`运行 ${d.testCmd} 确认全部测试通过、无回归`);
-	else parts.push(`按 ${d.language || "项目"} 的常规测试方式编写并运行测试，确认核心逻辑正确、无回归`);
-	if (d.lintCmd) parts.push(`运行 ${d.lintCmd} 符合代码规范`);
-	if (d.hasPreCommit) parts.push("通过本地 pre-commit 钩子检查");
-	if (d.hasCI) parts.push("通过 CI 检查");
-	if (parts.length === 0) parts.push("核心逻辑正确、边界情况处理完善、无行为回归");
-	return parts.join("；");
+/** 根据项目探测结果生成常规验收标准条目（测试 + lint + pre-commit + CI）。 */
+export function defaultAcceptanceItems(d: ProjectDefaults): string[] {
+	const items: string[] = [];
+	if (d.testCmd) items.push(`运行 ${d.testCmd} 确认全部测试通过、无回归`);
+	else items.push(`按 ${d.language || "项目"} 的常规测试方式编写并运行测试，确认核心逻辑正确、无回归`);
+	if (d.lintCmd) items.push(`运行 ${d.lintCmd} 符合代码规范`);
+	if (d.hasPreCommit) items.push("通过本地 pre-commit 钩子检查");
+	if (d.hasCI) items.push("通过 CI 检查");
+	return items;
 }
 
 /**

package/extensions/ui-helpers.ts

@@ -8,9 +8,10 @@
  *   - uiSelect()     — replaces ctx.ui.select() with wrapping
  *   - uiConfirm()    — replaces ctx.ui.confirm() with wrapping
  *   - uiInput()      — replaces ctx.ui.input() with wrapping
+ *   - uiTaskArg()    — 命令参数或输入框二选一取任务文本
  */
 
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import {
     Box,
     Container,
@@ -28,7 +29,7 @@ import { Key, matchesKey } from "@earendil-works/pi-tui";
 
 // ── Types ────────────────────────────────────────────────────
 
-type Theme = ExtensionCommandContext["ui"]["theme"];
+type Theme = ExtensionContext["ui"]["theme"];
 
 // ── Constants ─────────────────────────────────────────────────
 
@@ -79,7 +80,7 @@ function dim(theme: Theme, text: string): string {
  * caller should check for it via choice === BACK_OPTION_TEXT.
  */
 export function uiSelect(
-    ctx: ExtensionCommandContext,
+    ctx: ExtensionContext,
     title: string,
     items: string[],
     backable = false,
@@ -136,7 +137,7 @@ export function uiSelect(
  * Returns true for Yes, false for No, "back" for back, undefined on cancel.
  */
 export function uiConfirm(
-    ctx: ExtensionCommandContext,
+    ctx: ExtensionContext,
     title: string,
     message?: string,
     backable = false,
@@ -210,7 +211,7 @@ export function uiConfirm(
  * When backable=true, supports Ctrl+Shift+← for back and Ctrl+Shift+→ for submit+next.
  */
 export function uiInput(
-    ctx: ExtensionCommandContext,
+    ctx: ExtensionContext,
     label: string,
     placeholder?: string,
     required = false,
@@ -294,6 +295,25 @@ export function uiInput(
     });
 }
 
+// ── Task argument helper ─────────────────────────────────────
+
+/**
+ * 取任务文本：优先使用命令参数，缺省时弹一次必填输入框。
+ * 参数为空、输入为空或用户取消时返回 undefined。
+ */
+export async function uiTaskArg(
+    ctx: ExtensionContext,
+    args: string,
+    label: string,
+    placeholder?: string,
+): Promise<string | undefined> {
+    const fromArgs = args.trim();
+    if (fromArgs) return fromArgs;
+    const input = await uiInput(ctx, label, placeholder, true);
+    const text = input?.trim();
+    return text ? text : undefined;
+}
+
 // ═══════════════════════════════════════════════════════════════
 //  Extension factory (no-op — ui-helpers is a helper module)
 // ═══════════════════════════════════════════════════════════════

package/package.json

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

package/prompts/APPEND_SYSTEM.md

@@ -1,10 +1,19 @@
 ## Global Agent Rules
 
 ### Language
-默认用简体中文回复；用户明确指定时再切换语言。
+默认用简体中文回复；用户明确指定其他语种时再切换语言。
 默认不使用 emoji，除非用户明确要求。
 回答应简短精炼且足够说明情况。
 
+### 思考过程
+**严格遵循：**审题 → 思考 → 汇总 → 验证 → 讨教 → 最终：
+1.审题：独立且清晰的确认用户意图，用自己的话重述你认为用户的目标是什么，以及用户试图解决的问题是什么。
+2.思考：独立的探索真实数据，分析事情(真实代码/数据/文档/现状)的实际价值。
+3.汇总：整合分析结果，区分事实、推断、假设；聚焦真正影响结果的关键因素。
+4.验证：假设当前正是用户目标完成时候的状态，但用户表示不满意，深入分析哪里没有做到位，把方案补全。
+5.讨教：遇到不确定、专业、时效性或陌生问题时，主动检索网络、官方文档、知识库、成熟案例，进行外部校验。
+6.最终：完成以上流程后再作答；**先结论，后依据**，优先给出最小闭环、可执行方案。明确不确定性，禁止编造。
+
 ### Working Style
 像高绩效资深工程师一样工作：直接、克制、执行优先。
 技术准确优先于迎合用户信念。专注事实和解决问题，提供直接、客观的技术信息，避免不必要的夸张、赞美或情感认同。
@@ -50,6 +59,7 @@ git commit 操作保持分批提交，避免一次性提交过多代码或多个
 ### Validation
 改完先做最相关的验证：优先针对性测试，再类型 /lint/build，最后最小冒烟。
 能跑就跑；不能跑就明确说明原因，不把静态阅读包装成运行时验证。
+查看项目中的CI,`.pre-commit-check.yaml`等内容(如有)，完成相关验证。
 
 ### Stop Rule
 每完成一个关键步骤就判断一次：是否已经能基于足够证据回答用户的核心请求。
@@ -58,6 +68,6 @@ git commit 操作保持分批提交，避免一次性提交过多代码或多个
 ### 核心理念
 高效达成请求结果，不过度工程。无范围蔓延。只实现直接要求的内容。无假想设计，无必要抽象，默认无注释。不为不可能条件加校验。无时间预估。无 emoji。无过度认同。准确、客观、简洁。始终牢记自己的身份和职责。
 
-**除用户明确要求执行特定操作外，默认严格遵循以上规范**
-**除用户明确要求执行特定操作外，默认严格遵循以上规范**
-**除用户明确要求执行特定操作外，默认严格遵循以上规范**
+**除用户明确要求执行特定操作外，默认严格遵循以上规范，在最终返回前确认已经遵守了[思考过程]的完整流程:审题->思考->汇总->验证->讨教->最终**
+**除用户明确要求执行特定操作外，默认严格遵循以上规范，在最终返回前确认已经遵守了[思考过程]的完整流程:审题->思考->汇总->验证->讨教->最终**
+**除用户明确要求执行特定操作外，默认严格遵循以上规范，在最终返回前确认已经遵守了[思考过程]的完整流程:审题->思考->汇总->验证->讨教->最终**