Yinyo Skill Craft — Skill 工匠
Skill 工程審計與互動式修復工具。基於 Perplexity Agents Team 官方指南 + Karpathy CLAUDE.md 編碼規範 + yinyo 系列實戰經驗。
新增能力：支援自動修復 + 用戶確認模式。
核心規則
1. Skill 是目錄，不是檔案
- 單檔案 > 50KB → 必須拆分為 hub-and-spoke 結構
- 標準結構：SKILL.md + README.md + docs/ + examples/ + subskills/
- 多級嵌套：300 主題 → 20 領域 → 15 主題/領域
2. Description 是路由觸發器
- 必須用
Load when...開頭 - 說明觸發條件，不是功能列表
- 控制在 50 字以內
3. 三級漸進式載入
| 層級 | Token 預算 | 內容 | 付費頻率 |
|---|---|---|---|
| Index | ~100 | name + description | 每會話 |
| Body | ~5000 | 核心規則 + 快速參考 | 載入後到 compaction |
| Runtime | 無上限 | docs/ + examples/ + subskills/ | 用到時 |
4. 刪除模型已知內容
- 解釋基礎概念 → 刪除
- 通用編程原則 → 刪除
- "If it's easy to explain, the model already knows it. Delete it."
5. Karpathy 編碼四原則
- Think Before Coding：不確定就問
- Simplicity First：200 行能寫完不寫 500 行
- Surgical Changes：只碰必須碰的
- Goal-Driven Execution：定義可驗證目標
互動式修復流程（新增）
修復原則
- 低風險（結構、格式、版本）→ 自動執行，事後彙報
- 中風險（描述重寫）→ 展示修改前後對比，用戶確認
- 高風險（內容刪除）→ 列出刪除清單，逐項確認
修復範圍
| 修復類型 | 範例 | 風險等級 |
|---|---|---|
| 結構調整 | 單檔案拆分為目錄 | 低 |
| 描述重寫 | 改為 Load when... | 中 |
| 內容刪除 | 刪除模型已知內容 | 高 |
| 版本同步 | 更新 version/last_updated | 低 |
| 格式規範化 | frontmatter 補全 | 低 |
修復流程
審計 → 列出問題 → 分類風險 → 用戶確認 → 自動修復 → 二次審計 → 報告結果
修復後驗證
- 自動執行二次審計
- 對比修復前後分數
- 生成修復報告（改了什麼、為什麼改、分數變化）
審計流程
輸入
用戶提供：
- Skill 目錄路徑，或
- SKILL.md 內容
輸出
生成審計報告：
## 審計報告：{skill-name}
### 結構審計
- [PASS/WARN/FAIL] 目錄結構
- [PASS/WARN/FAIL] 檔案大小
- [PASS/WARN/FAIL] 層級深度
### 內容審計
- [PASS/WARN/FAIL] Description 寫法
- [PASS/WARN/FAIL] 模型已知內容檢測
- [PASS/WARN/FAIL] 信號密度
### 版本管理
- [PASS/WARN/FAIL] 版本號格式
- [PASS/WARN/FAIL] 同步狀態
### 總分：{X}/100
### 建議：{priority actions}
反模式檢測清單
結構反模式
- 單檔案膨脹（> 50KB）
- 描述過長（> 100 tokens）
- 無層級（> 50 個主題平鋪）
- 無版本管理
內容反模式
- 模型已知內容（基礎概念解釋）
- 過度工程（抽象層 > 實際需求）
- 流程表演（約束執行合規而非成品品質）
- 無驗證標準
yinyo 特有毒點
- 版本回退猶豫（品質下降不立即回退）
- 流程越完整品質越差（yinyo-writer 教訓）
- 單檔案 277KB（yinyo-liuyao 教訓）
修復建議模板
單檔案膨脹 → 拆分
原：SKILL.md (277KB)
新：
├── SKILL.md (5KB: 核心規則)
├── docs/
│ ├── rules.md (50KB: 120條規則)
│ ├── examples.md (100KB: 412卦例)
│ └── reference.md (30KB: 64卦納甲表)
└── subskills/
├── edge-case-1.md
└── edge-case-2.md
Description 錯誤 → 修正
❌ "This Skill helps you write articles."
✅ "Load when the user needs to write a WeChat public account article."
快速參考
Skill 命名
yinyo-{domain}-{action}
檔案大小
- Index: < 1KB
- Body: < 50KB
- Runtime: 無上限
版本管理
- SemVer: MAJOR.MINOR.PATCH
- 每次更新同步：SKILL.md + README.md + Git commit + memory
修復觸發詞
- "修復這個Skill" → 進入互動式修復模式
- "自動修復" → 執行低風險修復
- "幫我改" → 展示修改建議，等待確認