1) src/promptBuilder.js（新增）

可組裝化的提示引擎。

// src/promptBuilder.js

/**
 * 一個可組裝的 Prompt Builder：
 * - role / goal / audience / constraints / style
 * - formatHint（輸出格式說明）
 * - fewShots（{user, assistant} 陣列）
 * - toMessages() 轉成 Chat Completions 可用 messages
 */

export class PromptBuilder {
  constructor() {
    this.role = "";
    this.goal = "";
    this.audience = "";
    this.constraints = [];
    this.style = "";
    this.formatHint = "";
    this.fewShots = []; // [{ user, assistant }]
    this.userInput = "";
    this.jsonSchema = null; // 若要結構化輸出
  }

  setRole(text) { this.role = text; return this; }
  setGoal(text) { this.goal = text; return this; }
  setAudience(text) { this.audience = text; return this; }
  addConstraint(text) { if (text) this.constraints.push(text); return this; }
  setStyle(text) { this.style = text; return this; }
  setFormatHint(text) { this.formatHint = text; return this; }
  setFewShots(pairs = []) { this.fewShots = pairs; return this; }
  setUserInput(text) { this.userInput = text; return this; }
  setJsonSchema(schema) { this.jsonSchema = schema; return this; }

  buildSystemPrompt() {
    const parts = [];
    if (this.role) parts.push(`角色：${this.role}`);
    if (this.goal) parts.push(`任務目標：${this.goal}`);
    if (this.audience) parts.push(`目標讀者：${this.audience}`);
    if (this.style) parts.push(`表達風格：${this.style}`);
    if (this.constraints.length) {
      parts.push(
        "限制條件：\n" +
        this.constraints.map((c, i) => `  ${i + 1}. ${c}`).join("\n")
      );
    }
    if (this.formatHint) parts.push(`輸出格式指引：${this.formatHint}`);

    // 若要求 JSON 格式，追加嚴格說明
    if (this.jsonSchema) {
      parts.push(
        "請務必輸出 **純 JSON**（不含多餘文字、註解或 Markdown），且鍵名及資料型別需符合 schema。"
      );
    }
    return parts.join("\n");
  }

  toMessages() {
    const messages = [
      { role: "system", content: this.buildSystemPrompt() },
    ];

    // few-shot
    for (const pair of this.fewShots) {
      if (pair.user) messages.push({ role: "user", content: pair.user });
      if (pair.assistant) messages.push({ role: "assistant", content: pair.assistant });
    }

    // 最後放真實使用者輸入
    if (this.userInput) messages.push({ role: "user", content: this.userInput });

    return messages;
  }
}

2) src/jsonGuard.js（新增）

輕量處理模型常見 JSON 輸出問題（前後多了字、或缺逗點）。

// src/jsonGuard.js

/**
 * 嘗試從模型輸出中抽出 JSON 並 parse。
 * - 會移除前後的 Markdown 區塊或多餘文字
 * - 若 parse 失敗，嘗試微調修復（非常保守）
 */
export function extractJson(text) {
  if (!text) throw new Error("空的模型輸出");
  // 移除 ```json ... ``` 或 ``` ... ``` 包裹
  const codeBlock = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
  const raw = codeBlock ? codeBlock[1] : text.trim();

  // 嘗試第一輪 parse
  try { return JSON.parse(raw); } catch (_) {}

  // 簡單修復：去除多餘換行、尾逗點
  const cleaned = raw
    .replace(/\n/g, " ")
    .replace(/,\s*}/g, "}")
    .replace(/,\s*]/g, "]")
    .trim();

  return JSON.parse(cleaned); // 若失敗會直接 throw，讓上層捕捉
}

/**
 * 極輕量 schema 驗證（只檢查必要欄位是否存在與型別）
 * schema 範例：
 * { type: 'object', required: ['label','confidence'], properties: { label:{type:'string'}, confidence:{type:'number'} } }
 */
export function validateBySchema(obj, schema) {
  if (!schema) return { ok: true, errors: [] };
  const errors = [];

  if (schema.type === "object") {
    if (typeof obj !== "object" || Array.isArray(obj)) {
      errors.push("根型別應為 object");
    } else {
      for (const key of (schema.required || [])) {
        if (!(key in obj)) errors.push(`缺少必要欄位：${key}`);
      }
      if (schema.properties) {
        for (const [k, def] of Object.entries(schema.properties)) {
          if (k in obj && def.type && typeof obj[k] !== def.type) {
            errors.push(`欄位 ${k} 型別應為 ${def.type}`);
          }
        }
      }
    }
  }
  return { ok: errors.length === 0, errors };
}

3) src/day3_prompt_engineering.js（新增）

三個任務示範＋JSON 產出。

// src/day3_prompt_engineering.js
import { openai } from "./aiClient.js";
import { PromptBuilder } from "./promptBuilder.js";
import { extractJson, validateBySchema } from "./jsonGuard.js";

/** 任務 A：英文老師（糾正文法，並解釋） */
export async function englishTeacher(input) {
  const pb = new PromptBuilder()
    .setRole("你是一位嚴謹且耐心的英文老師")
    .setGoal("糾正句子的文法與用字，並以簡潔中文解釋原因")
    .setAudience("具備國高中程度的學習者")
    .addConstraint("以條列方式呈現修改建議")
    .addConstraint("給出 1~2 個替代說法")
    .setStyle("專業、清楚、避免過度口語")
    .setFormatHint("使用 Markdown，分為『修正句子』『說明』『替代說法』三段")
    .setUserInput(`請幫我修正並說明這句話：${input}`);

  const res = await openai.chat.completions.create({
    model: "gpt-4o-mini",
    temperature: 0.4,
    messages: pb.toMessages(),
  });

  return res.choices?.[0]?.message?.content?.trim();
}

/** 任務 B：程式碼審查（指出風險、修正範例） */
export async function codeReview(snippet, language = "javascript") {
  const pb = new PromptBuilder()
    .setRole("你是經驗豐富的資深工程師與安全審查者")
    .setGoal("審查程式碼品質、可維護性、安全風險，並提出具體修正")
    .addConstraint("請使用分段：風險、原因、修正建議、重構後範例")
    .addConstraint("避免廢話，指出可量化的問題（時間複雜度、可能例外、邊界條件）")
    .setStyle("專業、直接、重視可讀性")
    .setFormatHint("以 Markdown 呈現，重構碼需標註語言")
    .setUserInput(`語言：${language}\n請審查以下程式碼：\n${snippet}`);

  const res = await openai.chat.completions.create({
    model: "gpt-4o-mini",
    temperature: 0.3,
    messages: pb.toMessages(),
  });

  return res.choices?.[0]?.message?.content?.trim();
}

/** 任務 C：文字分類（few-shot）→ 要求純 JSON 輸出 */
export async function sentimentClassify(text) {
  const schema = {
    type: "object",
    required: ["label", "confidence", "reasons"],
    properties: {
      label: { type: "string" },       // positive | neutral | negative
      confidence: { type: "number" },  // 0~1
      reasons: { type: "string" }
    },
  };

  const fewshots = [
    {
      user: "我今天升遷了，超級開心！",
      assistant: `{"label":"positive","confidence":0.92,"reasons":"語氣正向，含正面事件（升遷、開心）"}`
    },
    {
      user: "好像也還好，沒有什麼特別的事。",
      assistant: `{"label":"neutral","confidence":0.72,"reasons":"描述平淡，缺少情緒色彩"}`
    }
  ];

  const pb = new PromptBuilder()
    .setRole("你是嚴謹的文字情緒分類器")
    .setGoal("判定給定中文句子的情緒傾向")
    .addConstraint("標籤僅能為 positive / neutral / negative 之一")
    .addConstraint("confidence 介於 0 與 1 之間")
    .setJsonSchema(schema)
    .setFewShots(fewshots)
    .setUserInput(text);

  const res = await openai.chat.completions.create({
    model: "gpt-4o-mini",
    temperature: 0.2,
    messages: pb.toMessages(),
  });

  const raw = res.choices?.[0]?.message?.content ?? "";
  const obj = extractJson(raw);
  const check = validateBySchema(obj, schema);
  if (!check.ok) {
    throw new Error("JSON 不符合 schema：" + check.errors.join("; "));
  }
  return obj;
}

4) index.js（更新為可跑 Day 3 範例）

// index.js
import { englishTeacher, codeReview, sentimentClassify } from "./src/day3_prompt_engineering.js";

const args = Object.fromEntries(
  process.argv.slice(2).reduce((acc, cur, i, arr) => {
    if (cur.startsWith("--")) {
      const key = cur.replace(/^--/, "");
      const val = arr[i + 1] && !arr[i + 1].startsWith("--") ? arr[i + 1] : true;
      acc.push([key, val]);
    }
    return acc;
  }, [])
);

async function main() {
  const task = args.task || "teacher";

  if (task === "teacher") {
    const input = args.text || "He go to school every day.";
    const out = await englishTeacher(input);
    console.log("\n=== 英文老師 ===\n");
    console.log(out);
  } else if (task === "review") {
    const sample =
`function sum(arr){
  let s = 0;
  for (let i=0;i<arr.length;i++){
    s += arr[i]
  }
  return s
}`;
    const out = await codeReview(sample, "javascript");
    console.log("\n=== 程式碼審查 ===\n");
    console.log(out);
  } else if (task === "sentiment") {
    const text = args.text || "今天心情糟透了，事情一團亂。";
    const out = await sentimentClassify(text);
    console.log("\n=== 情緒分類(JSON) ===\n");
    console.log(out);
  } else {
    console.log("未知任務，請使用 --task teacher | review | sentiment");
  }
}

main().catch((e) => {
  console.error("發生錯誤：", e.message);
  process.exit(1);
});

5) package.json（新增 Script）

只需在原本 scripts 內加以下三條（保留你之前的）。

{
  "scripts": {
    "day3:teacher": "node index.js --task teacher --text \"This sentence have a error.\"",
    "day3:review": "node index.js --task review",
    "day3:sentiment": "node index.js --task sentiment --text \"我覺得今天很棒，效率超好！\""
  }
}

如何執行

# 英文老師（糾正＋說明）
npm run day3:teacher --silent

# 程式碼審查
npm run day3:review --silent

# 情緒分類（JSON 結構輸出）
npm run day3:sentiment --silent