個人目標
IFA 前端開發 Agent Skills
16 個 Skill 模組 / v0.7.0 / 四層驗證框架
AI/BI 視覺化元件庫
三庫比較 / 3,411 LOC / 可重用元件庫
C# 進階學習
async/await + LINQ / IFA 應用對照
Obsidian PKM
9 分類 / 8 模板 / 11 則結構化筆記
iPAS AI 初級證照
順延至 Q2,目標 5/16 應考
例行工作
協助其他部門技術
採購網系統導入 / 教育訓練
動態表單規劃
本季無交辦工單,已由同仁完成
IFA 前端開發 Agent Skills
自我評述
本季原定目標為產出一份涵蓋 React 元件開發規範、公司既有前端模組使用慣例、API 呼叫模式及頁面路由與狀態管理準則的 Skills.md 文件。實際執行成果遠超預期,已建構出一套完整的 AI Agent Skills 框架體系(skills4ifa),目前版本 v0.7.0。
透過 Skill 模組化設計,開發者可直接以自然語言指令驅動 AI 進行 IFA 開發,從需求理解到程式碼生成再到驗證產出形成閉環,預估可加速開發效率 30% 以上(超越原定 20% 目標)。
關鍵數據
具體成果
Skill 模組體系
涵蓋前端 Views 開發、元件使用、API 整合、樣式規範、規格書撰寫、計畫擬定、品質檢測、驗證輸出等完整開發生命週期。
驗證框架
四層驗證架構——L1 斷言驗證(Assertion)、L2 信任分數(Trust Score v5)、L3 技術檢查(Tech Checker)、L4 合併報告(Verification Report),確保 AI 生成程式碼的品質可量化追蹤。
教育訓練
投影片 26 張、講者稿、Q&A 卡片、設置指南、觀察指南等完整訓練材料,並完成 PDF 及 PPTX 版本。規格書撰寫指南 33KB / 770 行,完整訓練計畫 57KB / 872 行。
後端延伸
已啟動後端 Controller Skill(developing-ifa-controllers),為 Q2 後端 Skills.md 提前佈局。
Skills 全景圖
skills4ifa 全景圖 — 16 個 Skill 模組的分層架構與工作流向
AI/BI 視覺化應用研究與元件庫建立
自我評述
原定目標為評估 Chart.js 與 D3.js 兩大視覺化框架,完成 POC 展示。實際執行擴展為三庫比較(加入 Recharts),並完成兩階段開發:Phase A 框架評估 + Phase B 可重用元件庫。
測試資料模擬 IFA IFAC010Q 預算執行報表的實際欄位結構,驗證元件庫可直接接入 IFA 資料格式,為後續 BI 視覺化導入奠定基礎。
關鍵數據
框架評估結果
| 評估維度 | 權重 | Chart.js | D3.js | Recharts |
|---|---|---|---|---|
| 開發效率 | 25% | 4 | 2 | 5 |
| IFA 適配性 | 25% | 4 | 3 | 4 |
| 可維護性 | 20% | 4 | 2 | 5 |
| API 設計 | 15% | 3 | 3 | 5 |
| 客製化能力 | 10% | 4 | 5 | 3 |
| 響應式 | 5% | 4 | 2 | 5 |
| 加權總分 | 100% | 3.85 | 2.70 | 4.55 |
最終選定 Recharts 作為 Phase B 正式框架
具體成果
Phase A — 三庫比較
以完全相同的 IFA 預算執行模擬資料(~150 筆,含 8 種邊界條件),分別以 Chart.js、D3.js、Recharts 實作折線圖、柱狀圖、圓餅圖、儀表板四種圖表,共 12 個圖表元件 + 3 個展示頁 + 1 個並排比較頁。
Phase B — 可重用元件庫
以 Recharts 封裝 4
個通用圖表元件(LineChart、BarChart、PieChart、Dashboard),設計
useChartData hook 作為資料轉換層,相容 IFA
masterData / opData 格式,支援 controlled / uncontrolled
雙模式。
文件產出
框架評估報告(六維度加權評分)+ Phase B 元件 API Reference 文件。
POC Demo
C# 進階學習
自我評述
已完成非同步設計模式與 LINQ 兩大主題的系統化學習,並產出完整學習成果文件。每個概念均對照 IFA 後端 KSI Kernel 框架的實際應用場景,確保學習成果可直接應用於 Q2 後端 Skills.md 撰寫。
學習主題
非同步設計模式
- async/await 基礎原理與命名慣例
- Task / Task<T> 三種狀態管理
- TAP(Task-based Asynchronous Pattern)
- 常見陷阱:避免 .Result/.Wait() 死鎖
- async void 使用限制
LINQ
- 方法語法 vs 查詢語法
- 篩選投影:Where、Select、SelectMany
- 聚合:Count、Sum、Average、Max/Min
- 分組連接:GroupBy、Join
- 延遲執行與 IEnumerable vs IQueryable
IFA 實際應用對照
DataTable + LINQ 查詢
使用 AsEnumerable() 將 DataTable 轉換後,以 LINQ
進行篩選與欄位提取。
Searched 事件資料後處理
在 SearchedEventArgs 事件中使用 LINQ 進行資料後加工與轉換。
多 DataTable 集合操作
Union 合併多個 DataTable、字串陣列的 WHERE 條件組合與必填欄位檢查。
Controller 非同步升級概念
理解 Controller Action 從同步升級為非同步的模式,以及 Transaction 的非同步處理。
Obsidian 個人知識管理系統
自我評述
已完成 Vault 結構設計與模板建立,並累積符合模板規範的筆記超過 10 則。PKM 系統已與日常工作流程整合,各季 KPI 產出均納入 Vault 管理。
關鍵數據
Vault 架構
模板系統
PKM 指南體系
建立 8 篇系統性指南:「為什麼寫筆記」、「筆記類型速查」、「每日工作流」、「筆記寫作指引」、「回顧與連結」、「AI 可讀性規範」、「團隊入門指南」、「Vault 結構地圖」,為團隊推廣 PKM 奠定基礎。
iPAS AI 應用規劃師 初級證照
自我評述
本季因 skills4ifa 開發工作量遠超預期(從原定 1 份 Skills.md 擴展為 16 個 Skill 模組 + 驗證框架 + 教育訓練材料),且視覺化 POC 亦擴展為三庫比較,導致 iPAS 學習時間被壓縮。
經評估後決定將 iPAS 初級與 Q2 原定之中階合併規劃,待確認下一梯次考試時間後統一安排讀書計畫。
考試梯次
Q2 讀書計畫 — iPAS 初級(目標 5/16 應考)
中級考試為 11/14,落在 Q4,故 Q2 聚焦初級備考。
讀書計畫
4/1 — 4/11:基礎概念
AI 基礎理論、機器學習概論、深度學習基礎。取得官方教材與歷屆題庫,完成第 1 回模擬試題。
4/14 — 4/25:應用領域
AI 應用場景(NLP、CV、推薦系統)、資料前處理與特徵工程、模型評估指標。完成第 2 回模擬試題。
4/28 — 5/9:進階主題與弱項補強
AI 倫理與法規、產業應用案例、模型部署概念。完成第 3 回模擬試題,針對弱項集中補強。
5/12 — 5/16:最終衝刺
全範圍模擬測驗、錯題回顧、考前重點整理。5/16(六)應考。
例行工作
協助其他部門技術(規劃/開發)
本季協助 V7 部門開發「採購網系統」,將開發流程導入 skills4ifa 框架,透過 Skill 模組化的方式協助該部門加速開發節奏。此外,透過 skills4ifa 的內部教育訓練,協助同仁認識 Agent Skills 的概念與操作方式,並即時排除同仁在使用上遭遇的問題。
協助研發開發產品化:動態表單規劃
本季動態表單規劃相關工作已由同仁完成,未產生交辦工單,故無對應執行成果。
官方 7 項 KPI(不標權重)。狀態依實際證據回填(repo 提交 + 專案筆記);事實來源為 Obsidian,本站為呈現層。期中盤點 W25,最終自評於 W26 產出。
官方 7 項 KPI
V1-BI 圖表導入與 OLAP 介接
ECharts 9 圖到齊 / src_olap 20 commits / 待對方驗收
V1 球場系統改版(agent)
傳授 skills4ifa 方法論協助 Delphi→React 遷移
skills4ifa 後端開發指南
能力地圖 / TDD 4-4 PASS / 網站素材已備
skills4ifa Plugify
已定 SKILL.md 主幹選型;v1 落地暫緩
Anthropic 學院 claude 101
4 張結業憑證 / 重點筆記納入 PKM
TanStack Query + Zustand
demo 18 測綠 / IFA 試點 PoC(已實測回填)
Obsidian PKM
308 則筆記 / 互連率待提升(口徑待定)
skills4ifa 後端開發指南 + FastReport 報表規範
能力地圖 — 方法論完整覆蓋整條後端開發鏈
C# 後端 API 開發規範
教 AI 照 IFA 分層架構寫「接住前端請求、處理資料」的後端程式。
SQL Server 預存程序準則
教 AI 寫「住在資料庫裡」的查詢/運算程式,命名、參數、交易一致。
FastReport 報表設計與資料綁定
教 AI 直接讀懂並修改公司列印報表模板,正確把資料綁進版面。
「禁止臆測」鐵則
把 AI 的「猜」改成「查 / 問」,是擋掉幻覺的關鍵。
TDD 實測 — 同一個 AI、同一批考題,加手冊前後的差距
我們用軟體界「先出考題、再驗收」的 TDD(紅燈→綠燈)方法,設計四道貼近真實工作的報表考題,實測「AI
有沒有讀手冊」的差距。沒手冊時 AI 拒答或答錯;載入手冊後四題全部通過。來源:developing-ifa-reports/testing/baseline-scenarios.md,對應
release v0.10.0。
拒答(引用 Red Flags:IFA 任務需先載入正確 skill)
FR 內部單位、[Table.REMARK] 綁定語法、帶區順序、三重名稱一致
拒答(沒有規格書=無法生成)
doExpXlsResult()(小寫 d)、Point(col,row)、isXlsColumns=false、檔名不加副檔名
拒答(無法提供系統化除錯指引)
第一步即指出「最可能是三重名稱不一致」,並給系統化 Grep 排查步驟
推薦 XlsTool,理由基於未驗證假設
正確推薦 FastReport(分組+小計→複雜排版),引用路徑決策樹
同一個 AI、同一批考題:加手冊之前「拒答或答錯」,加手冊之後「全部答對」。
用數據說話 — 品質可量化驗證
Q2 commit 數採日曆月口徑 336(字面 --since/--until 口徑為
324,差 12 筆為時區邊界);4/4 PASS 經 baseline-scenarios.md +
release CHANGELOG 雙證。repo 總 commit 725。
最有感的一頁 — AI 最容易猜錯的綁定語法
這些「看起來很小、錯了就全壞」的細節,正是 AI 最容易用業界通則猜錯的地方。手冊把「正確寫法」和「常見錯法」並列,AI 就不會搞錯。
| 項目 | AI 常猜錯(沒手冊) | 正確(有手冊) |
|---|---|---|
| 欄位綁定 | {Table.Col} / ${Table.Col} | [Table.Col] |
| 參數綁定 | :Param | [@Param] |
| 座標單位 | 像素 / 公分 | FR 內部單位(1cm≈37.8) |
| 匯出方法大小寫 | DoExpXlsResult() | doExpXlsResult() |
TanStack Query + Zustand 比較(評估導入 IFA)
自我評述
範圍擴充為「server 狀態(TanStack Query)vs client 狀態(Zustand)」對照,並以 side project demo 實作學習與驗證,最後做 IFA 試點 PoC 評估導入可行性。demo 以同一待辦 CRUD 情境分別實作,Vitest TDD 共 18 測全綠、build 通過。
關鍵數據
TanStack Query vs Zustand — 互補非二選一
| 維度 | TanStack Query | Zustand |
|---|---|---|
| 管理對象 | 伺服器狀態(API 資料) | 用戶端狀態(UI / 本地) |
| 快取 / 失效 | 內建(staleTime / gcTime / invalidate) | 無(需自理) |
| 重取 / 同步 | 自動(背景重取、focus 重取) | 手動 |
| 樂觀更新 | onMutate / rollback 內建模式 | 自行實作 |
| 適用 | 清單 / 主檔 / CRUD 打 API | 跨元件 UI 狀態、表單暫存 |
結論:兩者互補——server 狀態交給 TanStack Query,client 狀態交給 Zustand,非二選一。
IFA 試點 PoC — 以真實現況回填遷移效益
新增一頁 IFA 試點(src/ifa-pilot/,往來銀行主檔情境):抽出集中式
typed API 層 + 一頁 useQuery / useMutation(含樂觀更新 /
快取失效)。下列現況數字均唯讀核實自 ifa_rd/frontend,用以修正先前估計。
現況:狀態管理
IFA 前端用 @reduxjs/toolkit ^2.2.2 +
react-redux ^9.1.0,無 react-query、無
zustand,且為純 JSX(0 個 .ts 檔)。
現況:API 呼叫散落度
grep -rl axios = 189 檔(直接 import 54 檔 /
312 行,分母 520)。Const.js 已集中 axios
instance + 401 攔截,真痛點是「各頁自接 loading / error /
狀態」而非「各頁自建 axios」。
發現:隔離的 RTK Query 實驗
已有一個隔離的 RTK Query 實驗(service/DataTable.js),但全專案僅
1 檔消費、baseUrl 仍指向測試站。
建議:漸進導入
先抽集中式 API 層、以單頁試點 useQuery / useMutation 驗證,再逐頁遷移;可與既有 RTK Query 實驗整併路線評估,避免一次性大改。
原始碼:side project repo tanstack-zustand-lab(Vite +
React + TS,含 README 比較與 IFA 可行性分析)。
Anthropic 學院 — claude 101 系列
自我評述
已完成 Anthropic 學院 claude 101 系列課程並取得四張結業憑證(Skilljar 可線上驗證)。課程重點整理為 takeaways 筆記、以雙向連結納入 PKM(同時支援第 7 項)。
結業憑證
課程重點 takeaways(已納入 PKM)
模型家族分層
Opus / Sonnet / Haiku 依「能力—速度—成本」分層;用最簡可行層級,不為省成本盲目降級。
清楚指令 + 範例
把任務講明白、給角色與輸出格式;提供 multishot 範例可大幅穩定輸出。
結構化輸出
用 JSON schema / 工具 strict 模式取得可解析結果,而非事後硬解字串。
上下文與 token
以官方 count_tokens 計量,勿用第三方 tokenizer 估算(會失準)。
工具使用 + MCP
tool_use → tool_result 迴圈;工具說明要寫「何時呼叫」;MCP 標準化外部連接。
Prompt caching 與安全
前綴比對快取可大幅省成本(讀取約 0.1×),注意靜默失效;讀回應前先檢查 stop_reason / refusal。
課程重點筆記已以雙向連結納入 PKM,支援第 7 項互連率。
協助其他部門技術
① V1-BI 圖表導入與 OLAP 介接
圖表模組(Phase 1+2)實質完成:ECharts 9 圖到齊(折線/柱/長條、堆疊、圓餅、雙軸、散佈+氣泡),含民國 parser、數值格式/排序、推薦圖型、PNG 匯出,並完成 code review 修正。瓶頸在對方部門的正式驗收/上線(外部依賴),非開發。
② V1 球場系統改版(agent)
支援型任務。核心痛點為 Delphi → React + .NET Core 技術遷移;做法不是本人直接開發,而是傳授 skills4ifa 方法論,讓對方團隊 fork 並在指導下適配、自行推進改版。待對方團隊的階段性成果與驗收回饋。
skills4ifa Plugify — 與 MCPs / AGENTs 串連之開發助手
自我評述
已完成技術選型決策:比較 MCP 協定、Claude Agent SDK、Agent Skills(SKILL.md)三條路,決策以 SKILL.md 開放標準為主幹(Claude Code 與 GitHub Copilot 原生共通、一份來源雙端可用、零 runtime),MCP 按需補充,不採託管 agent runtime(無法裝進 Copilot)。已定 v1 MVP 邊界與整合介面草案。
技術選型決策
| 維度 | MCP 協定 | Claude Agent SDK | Agent Skills(SKILL.md) |
|---|---|---|---|
| 定位 | 工具 / 資料連接標準 | 託管 agent 執行框架 | 可攜技能包(開放標準) |
| Copilot 雙端共通 | 部分 | 否(裝不進 Copilot) | 是(原生共通) |
| runtime 需求 | 需 server | 需 runtime | 零 runtime |
| 與 skills4ifa 契合 | 補充 | 低 | 高(既有 skills 直接打包) |
決策=以 SKILL.md 開放標準為主幹,MCP 按需補充。
v1 落地本季暫緩
v1 落地(建 repo、整理可攜 SKILL.md 包、Claude Code + Copilot 雙端載入實測)本季暫緩,資源優先投入其他項;技術選型結論不變,待後續排程接續。
Obsidian PKM — 穩定產出 + 雙向連結
自我評述
持續產出但低於目標。KSI vault 現 308 則(Q1 基準約 289 →
約 +19,目標 +30);含 [[ ]] 連結之筆記約
17%(目標 50%),雙向連結 158 處。本季已先把 Anthropic 課程重點等納入。
現況數據
口徑待定,再衝刺
「新筆記」起算基準與「互連率 ≥ 50%」的精確定義待確認;口徑確定後集中衝刺新筆記數量與補既有筆記的雙向連結。