kami

kami · 紙

紙 · かみ - 承載你交付成果的紙張。

優秀的內容值得配上精美的紙張。跨文件與一頁式網站的統一設計語言：暖羊皮紙畫布、墨藍色調點綴、襯線體主導的視覺階層，以及緊湊的排版節奏。

屬於 Kaku · Waza · Kami 系列之一：Kaku 負責撰寫程式碼、Waza 負責養成習慣、Kami 負責交付文件。

更新檢查（非阻斷式）。 在任務開始時執行 bash scripts/check-update.sh。此指令每天最多進行一次唯讀的版本檢查，若有新版 kami 可用時會列印一行提醒；請將該行訊息轉達給使用者後繼續執行。它不會傳送任何資料，且在離線、沙盒環境或缺少 curl 時會靜默失敗，切勿讓它阻礙工作進行。

Step 0 · 載入品牌設定檔（若存在）

檢查 ~/.config/kami/brand.md（優先）或 ~/.kami/brand.md（舊版備用）。若找到設定檔，請參閱 references/brand-profile.md 了解完整的四層套用規範（預留位置替換、會話預設值、視覺自訂、習慣備註）及其六項防護規則。若不存在設定檔，則直接繼續，不打斷流程。

關鍵規則：明確 Prompt > 排版編輯判斷 > 習慣備註 > Frontmatter 預設值 > 內建預設值。設定檔僅用於靜默填補空白，絕不覆蓋當前對話中的要求。

Step 0.5 · 使用者專案風格掃描（選用）

僅在使用者明確指定參考同級專案的視覺風格時執行，例如：「像我的 <project> 網站」、「匹配 <repo> 的風格」、「使用 <directory> 的視覺樣式」。若未提供此類參考，請靜默跳過。

觸發時，在生成內容前：

1. 定位受參考專案的樣式檔案：

   find <referenced-path> -maxdepth 4 \( -name "*.css" -o -name "tailwind.config.*" -o -name "theme.*" -o -name "tokens.*" \) | head -20
   

2. 擷取：主色值（hex / hsl）、字型疊加（font stack）、間距階層、圓角階層。優先使用 CSS 變數或 Design Tokens 中宣告的值，而非內聯字面值。
3. 合併至當前會話的品牌設定檔中作為 Layer C（視覺自訂），而非 Layer B（會話預設值）。切勿覆蓋明確的 --brand 標記或使用者在本輪對話中手動輸入的值。
4. 在繼續前以單行回報：「已掃描 <project>，擷取 N 種顏色 / M 種字型；已作為視覺參考套用。」

若參考路徑不存在、未找到類 CSS 檔案，或擷取結果與使用者在當前訊息中的明確值衝突，請跳過並退回使用品牌設定檔預設值。

---

Step 1 · 決定語言

配對使用者的語言。 中文 -> *.html / slides-weasy.html。英文 -> *-en.html / slides-weasy-en.html。日文 -> 盡力支援 CJK 路徑（.html / slides-weasy.html），優先使用日文明體，交付前需進行視覺 QA。韓文 -> 盡力支援專用 *-ko.html / slides-weasy-ko.html 系列，交付前需進行視覺 QA。參考文件皆為共享的英文規範。

語意模糊時（例如僅輸入「resume」等單詞指令），請以單行簡短提問確認，而非盲目猜測。

使用者語言	HTML 模板	簡報（PDF 預設）	簡報（PPTX 備用）
中文（主要）	*.html	slides-weasy.html	slides.py
英文	*-en.html	slides-weasy-en.html	slides-en.py
日文（盡力支援）	*.html	slides-weasy.html	slides.py
韓文（盡力支援）	*-ko.html	slides-weasy-ko.html	不適用（僅在需要 PPTX 時使用 slides-en.py）
其他語言（盡力支援）	根據字元集涵蓋率選擇 CJK 或 EN 路徑，隨後手動驗證	選擇 slides-weasy.html 或 slides-weasy-en.html，隨後手動驗證	僅在需要 PPTX 時使用 slides.py / slides-en.py

預設使用 WeasyPrint HTML 路徑；僅在使用者明確需要可編輯的 Deck 時，才退回使用 PPTX（slides*.py）。

請務必使用 CHEATSHEET.md 與 references/*.md 來指導設計、寫作、製作及圖表製作。

帶有 class="language-*" 的程式碼區塊僅在建置環境中安裝了可選的 Pygments 時才會進行語法高亮。若未安裝，PDF 仍可正常渲染，僅程式碼區塊維持單色顯示。

Step 1.5 · 意圖擷取（靜默核對清單）

在選擇模板前，請確認以下四個面向皆已明確。除非缺失 2 個以上且無法從上下文推斷，否則請勿打擾使用者提問。

面向	需擷取的內容	範例
目的（Purpose）	此文件為何存在	說服投資人 vs. 對齊內部團隊 vs. 招募候選人
目標受眾（Audience）	誰會閱讀、他們已有何背景知識	技術 CTO（跳過基礎概念）vs. 非技術背景董事會（需解釋專有名詞）
限制條件（Constraint）	長度、格式、語氣或交付方式的硬性限制	「最多一頁」、「正式英文」、「可列印 A4」
成功標準（Success）	達成何種結果才算成功	他們預約會議 / 他們批准預算 / 他們理解架構

規則：

• 若對話中已涵蓋某個面向，請靜默跳過。
• 若某面向可從文件類型推斷（例如履歷的目的固定為「獲得面試機會」），請靜默跳過。
• 若確實有 2 個以上的面向不明確，請以單個精簡問題提問（最多包含 2 個子問題）。
• 切勿將四個面向作為填表核對清單一次性詢問。這是背景驗證機制，而非問卷調查。

執行契約

在建立或修改輸出前，請先鎖定契約內容：語言、模板、輸出格式、頁數或長度目標、視覺驗收檢查，以及驗證指令。若語意清晰請從使用者需求中推斷；僅在缺少欄位會重大影響交付成果時才提問。

請使用最接近的現有模板與驗證路徑。除非當前需求無法在現有條件下滿足，否則切勿新增模板、共享 CSS 層、依賴項、腳本標記或可選模式。

若變更涉及 SKILL.md、模板、腳本、參考資料或套件輸入，請決定是否需要在交付前重新整理 dist/kami.zip。在套件包含最新的變更檔案之前，交付的行為不算完備。

---

Step 2 · 選擇文件類型

使用者輸入	文件類型	中文模板	英文模板	韓文模板
"one-pager / 方案 / 执行摘要 / exec summary"	單頁摘要	one-pager.html	one-pager-en.html	one-pager-ko.html
"white paper / 白皮书 / 长文 / 年度总结 / technical report"	長文件	long-doc.html	long-doc-en.html	long-doc-ko.html
"formal letter / 信件 / 辞职信 / 推荐信 / memo"	信件	letter.html	letter-en.html	letter-ko.html
"portfolio / 作品集 / case studies"	作品集	portfolio.html	portfolio-en.html	portfolio-ko.html
"resume / CV / 简历 / 履歴書"	履歷表	resume.html	resume-en.html	resume-ko.html
"slides / PPT / deck / 演示"	簡報	slides-weasy.html	slides-weasy-en.html	slides-weasy-ko.html
"个股研报 / equity report / 估值分析 / investment memo / 股票分析"	個股研報	equity-report.html	equity-report-en.html	equity-report-ko.html
"更新日志 / changelog / release notes / 版本记录"	更新日誌	changelog.html	changelog-en.html	changelog-ko.html
"landing page / 落地页 / 官网 / product page / 产品页"	一頁式網站	landing-page.html	landing-page-en.html	landing-page-ko.html

更新日誌 vs. 發布說明（Release Notes）：上述的更新日誌模板適用於具備排版樣式的文件輸出。GitHub 上的 Release Notes 屬於單獨的交付物；請使用 /write 並切換至 Release Note Template Mode。

一頁式網站（Landing Page）：以螢幕展示優先的互動式模板。不輸出 PDF。包含支援自動輪播的圖庫、Hero 區段進場動畫、響應式斷點（880px / 480px），以及 prefers-reduced-motion 支援。可作為靜態 HTML 部署至 Vercel / Netlify 或任何主機。Agent 會填入 {{PLACEHOLDER}} 值與 HTML 註解區塊，隨後儲存為可直接提供服務的 .html 檔案。

一頁式網站周邊配套檔案：若要進行生產環境的多語言部署，請複製主 HTML 旁的 5 個 landing-page-*.example 檔案，移除 .example 後綴，並填入預留位置。這些檔案涵蓋 Vercel 重寫與 Header 設定、Sitemap hreflang、Robots AI 允許清單，以及供 AI 助理使用的 llms.txt + llms-full.txt。主要 HTML 內建的 <head> 已包含對應的 hreflang 與 og:locale；landing-page-en.html 末尾的 Accept-Language 重定向已預設註解，可依需求開啟。{{SITE_ORIGIN}} 為 {{CANONICAL_URL}} 的 Scheme + Host（例如 https://example.com）。詳情參閱 references/design.md 第 11 節 «Companion assets»。

生產級產品網站模式：若使用者需要文件、說明中心、發布說明、更新日誌、路線圖、法律條款頁面或超過兩種語言，請將其視為完整網站系統處理。在填寫模板前，先鎖定產品類別、真實截圖預留位、語言清單、周邊配套檔案、長內容頁面以及生成器/檢查需求。切勿將專案特有的發布產物、金流服務商、Appcast 規則及本地方案路徑混入 Kami。詳情參閱 references/design.md 第 11 節 «Product site system»。

說明文件頁面：當一頁式網站擴展為文件或說明中心時，請使用 references/design.md 第 11 節 «Documentation site» 中定義的框架：具備 2px 品牌導軌的置頂側邊欄導覽（非深色底線）、在平板斷點以下隱藏的頁內目錄（TOC）、受限的正文寬度，以及安靜無邊框的前後頁切換器（純文字連結，非帶邊框卡片）。在建置階段進行程式碼語法高亮，使深色程式碼區塊在執行階段達到零 JS；原始程式碼始終作為唯一事實來源。

簡報：預設使用 slides-weasy.html / slides-weasy-en.html / slides-weasy-ko.html（WeasyPrint HTML → PDF）。僅在使用者明確需要可編輯的 PPTX 檔案時才使用 slides.py / slides-en.py。僅在使用者明確要求使用 Marp / markdown slides / 存在於 .md 檔案中的 Deck 時才使用 assets/templates/marp/slides-marp(.md|.css)。

簡報製作指南：撰寫簡報草稿前請先閱讀 design.md 第 8 節。在生成或裁切視覺素材前，先草繪標題序列、論據結構與圖片預留位。將受眾文案與視覺簡報分開處理。Marp 專屬限制詳見 design.md §8 «Marp variant»。

決策樹（提問前先查閱）

在拋出單行簡短提問前，請先檢視此決策樹。僅在兩個選項皆確實符合時才提問。

訊號	建議文件種類
長度目標未知	在分類前先詢問「預計需要多少頁」
≤ 1 頁 + 目標受眾為投資人 / 招募人員 / 執行摘要需求	單頁摘要（one-pager）
≤ 1 頁 + 正式書信（銷售、招募、離職信、備忘錄）	信件（letter）
1.5-2 頁 + 職涯敘事 + 專案重點條列	履歷表（resume）
3-6 頁 + 專案展示 + 視覺比重高	作品集（portfolio）
6-15 頁 + 連貫論述 + 視覺密度低	長文件（long-doc）
簡報展示流程 + 講者輔助 + 每頁單一核心論點	簡報（slides）
財務 / 指標儀表板 + 投資論點 + 價格或風險分析	個股研報（equity-report）
逐版本紀錄 + 發布事實	更新日誌（changelog）
產品展示 + 定價 + 截圖 + 瀏覽器 FAQ	一頁式網站（landing-page）

合理解釋單行提問的歧義範例：

• 「1.5 頁且包含大量視覺素材的職涯故事」-> 詢問：「要製作履歷表還是作品集？」
• 「2 頁包含指標區塊的執行摘要」-> 詢問：「要製作單頁摘要還是個股研報？」
• 「5 頁包含數張圖表的論述文件」-> 詢問：「要製作長文件還是作品集？」

請優先從決策樹中選擇。僅在決策樹無法涵蓋時才提問。

圖表（為基本元件，非獨立模板類型）

當使用者要求在長文件 / 作品集 / 簡報內部插入圖表（而非製作獨立文件）時，請指引至 assets/diagrams/，而非使用模板：

使用者輸入	圖表類型	模板