菜单
blogsearch 向量 index 的生命週期管理：偵測 index 過時或不存在、觸發 rebuild、驗證結果。適用於有 blogsearch 語意搜尋工具的專案。觸發詞：blogsearch、rebuild index、ingest、向量搜尋、語意搜尋、index 過時、content 變動、pull 後 rebuild、新增文章後搜尋。Trigger when content changes may have made the search index stale, or when semantic search is needed.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Composes atomic, intent-revealing, grep-friendly writing (Zettelkasten) for code comments, docs, log
Composes atomic, intent-revealing, grep-friendly writing (Zettelkasten) for code comments, docs, logs, prompts, schema/ticket fields, external-analysis transformation, and long-form technical articles. Use when cognitive load and token cost matter. **Also triggers during multi-round review / batch review / 寫作 audit** — provides the keyword bank (正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架 / 澄清式框架) and frame-specific check lists that multi-round-review reviewer agents need. Triggers: 寫註解, 寫文件, 寫日誌, 寫 prompt, 寫文章, 技術文章, 商業分析, 外部分析文章, 經驗談轉教學, 訪談整理, 機制重建, post-mortem, 架構決策, 除錯復盤, 欄位設計, atomic, reusable, 多輪審查, multi-round review, batch review, 寫作 audit, 正向陳述, 口語修辭, 字句層 grep.
寫多篇章節後做多輪 agent reviewer audit 的標準操作流程。每輪用不同 frame 切換、跨輪 finding 互不重疊、停止訊號是 frame 涵蓋而非 finding 數遞減。Round 1-A 寫作規範 reviewer 必須同步 invoke `compositional-writing` skill 的字句層 keyword bank（正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架）、且命中後要做語意判定（命中是候選不是判決）。觸發詞：多輪審查、Round 1/2/3、frame 切換、跨輪審查、reviewer 規劃、何時停止 review、寫作 audit、batch review、cadence 同骨化、enumeration 不窮盡、正向陳述、self-application sweep。Trigger when reviewing multiple writings via successive rounds of agent reviewers.
寫完核心章節 / 教學模組後評估「該補哪些延伸內容」的標準流程。產出 6 軸候選 + ROI 矩陣 + 立即補 / backlog 排序、避免完美主義 collapse 跟覆蓋率不足兩種反向誤判。觸發詞：延伸評估、補章節、章節後續、評估缺口、規模成長後續、extension 候選、內容後續、模組完成評估、長期維護、知識卡缺口、跨章整合、vendor 深入。Trigger when evaluating what extensions to add after completing a batch of teaching chapters.
框架無關的前端開發協議 + Playwright 驗證 + 跨領域 Stream 操作架構：DOM topology 先於 CSS、CSS / JS 邊界辨識、Playwright 三個位置（假設 / 行為 / 互動驗證）、寫成 layout 測試、framework-managed DOM 共處、Reactive 效能盤點、a11y 三道防線、Filter × Source 層錯位 + 五策略合成（適用前端 / 後端 / 演算法 / DB）。Triggers: 寫 CSS, selector 精準, CSS layers, CSS-only vs JS, class toggle, MutationObserver, observer scope, polling, framework 共處, 外部組件客製, custom UI 邊界外, playwright 驗證, browser_evaluate, layout test, focus management, aria-live, keyboard a11y, reactive 效能, runtime cost, layout reflow, lazy loading, 前端網頁開發, vanilla, vue, react, jquery, filter × source, 層錯位, paginated source, post-filter, 自動續抓, 推進 query, 誠實進度 UX, 演算法 pipeline, middleware filter, materialized view, map-reduce.
從需求確認到實作的對話協議：模糊指令澄清（含篩選類）、可決定 vs 該確認的邊界、失敗 2 次的轉折、覆寫成本告知、revert/checkpoint 處理、漸進驗證、工具切換時機。Triggers: 收到模糊指令, 自決還是確認, 反覆失敗, 換思路, 覆寫成本, 先還原, 先重來, placeholder, 最小範圍, 推理失敗, playwright 切換, 開發前澄清, 需求確認, 排除障礙, 逼近答案, 依 X 篩選, 只看 X, filter 範圍, 呈現決策, 開放問, ABCDE 你選哪個, 反省題, retrospective, 下一步往哪走, 五維度, 需要我繼續嗎, 要做嗎, OK 嗎, yes/no, 二選, 確認嗎.
| name | blogsearch-lifecycle |
| description | blogsearch 向量 index 的生命週期管理：偵測 index 過時或不存在、觸發 rebuild、驗證結果。適用於有 blogsearch 語意搜尋工具的專案。觸發詞：blogsearch、rebuild index、ingest、向量搜尋、語意搜尋、index 過時、content 變動、pull 後 rebuild、新增文章後搜尋。Trigger when content changes may have made the search index stale, or when semantic search is needed. |
| license | MIT |
| metadata | {"version":"1.2.0","category":"tooling-lifecycle"} |
管理 blogsearch 向量搜尋工具的 index rebuild 時機、流程與驗證。向量 index 是 derived artifact（不進 git），content 變動後需要 rebuild 才能反映最新內容。
bin/blogsearch 已 build（cd scripts/blogsearch && go build -o ../../bin/blogsearch .）ollama serve）nomic-embed-text 已 pull（ollama pull nomic-embed-text）以下情境代表 index 可能過時或不存在，需要評估 rebuild：
| 情境 | 偵測方式 | 動作 |
|---|---|---|
| Index 不存在 | .blogsearch/ 目錄不存在 | 提示 full rebuild |
| 寫完新文章 | 對話中剛建立 content/**/*.md | 提示 rebuild |
| git pull 拉到 content 變動 | git diff --name-only HEAD@{1} 含 content/ | 提示 rebuild |
| 用戶要求語意搜尋 | 對話中提到搜尋相關內容 | 先檢查 index 是否存在，不存在就提示 |
| 換 embedding model | embed.go 的 Model 變數被修改 | 提示 full rebuild（舊 embedding 不相容） |
用戶在對話中說「rebuild index」「更新搜尋」「blogsearch ingest」時直接執行。
所有指令都封裝在 scripts/blogsearch/Makefile。以下是對應的 make target：
cd scripts/blogsearch && make install # build binary + pull embedding model
前提：Ollama 已在跑（ollama serve &）。make install 會檢查 Ollama 狀態、pull nomic-embed-text、build binary。
cd scripts/blogsearch && make ingest # build index（全量 ~4 分鐘）
預期輸出：逐檔列出 chunk 數、最後顯示總 chunk 數與耗時。
cd scripts/blogsearch && make verify # status + test query
驗證判準：
status 顯示 chunk 數 > 0、dimensions = 768query 回傳的 top-1 結果包含相關文章（如 vector-storage-engineering）| 錯誤 | 原因 | 修法 |
|---|---|---|
connection refused | Ollama 沒跑 | ollama serve & |
model not found | 沒 pull 模型 | ollama pull nomic-embed-text |
no records to save | content 目錄空或路徑錯 | 檢查 -content 參數 |
| 結果品質差 | CJK chunking 問題或 embedding 模型不適合 | 先跑幾個已知 query 確認，必要時換 embedding model |
| 情境 | 行為 |
|---|---|
| 用戶明確要求 rebuild | 直接執行 |
| 用戶要求語意搜尋但 index 不存在 | 提示「index 不存在，要先 rebuild 嗎？」 |
| 寫完文章、對話自然結束 | 提示「新文章還沒進 index，要 rebuild 嗎？」 |
| git pull 後 | 不主動提，除非用戶接著做語意搜尋 |
原則：rebuild 需要 Ollama 在跑（外部 dependency），不適合無條件自動執行。提示優先於自動。
blogsearch query 替代手動翻 collection indexVersion: 1.3.0 — SOP 改用 Makefile target（install / ingest / verify）、description 補 ingest 觸發詞