Initial commit
This commit is contained in:
Zhongwei Li
11
.claude-plugin/plugin.json
Normal file
11
.claude-plugin/plugin.json
Normal file
@@ -0,0 +1,11 @@
|
||||
{
|
||||
"name": "document",
|
||||
"description": "Document tools",
|
||||
"version": "1.0.0",
|
||||
"author": {
|
||||
"name": "Miles Chou"
|
||||
},
|
||||
"commands": [
|
||||
"./commands"
|
||||
]
|
||||
}
|
||||
84
commands/compact.md
Normal file
84
commands/compact.md
Normal file
@@ -0,0 +1,84 @@
|
||||
---
|
||||
description: Document compact
|
||||
model: claude-sonnet-4-5
|
||||
---
|
||||
|
||||
精簡文件內容，保留核心價值並減少冗餘。
|
||||
|
||||
仔細分析指定文件的內容，識別重複、冗餘或可以精簡的部分，在保持核心資訊完整的前提下適度減少內容長度。
|
||||
|
||||
## 執行流程
|
||||
|
||||
1. **深度分析文件結構**
|
||||
- 識別章節層次和邏輯關係
|
||||
- 分析內容重複性和必要性
|
||||
- 評估資訊密度和價值
|
||||
|
||||
2. **精簡策略應用**
|
||||
- 合併相似或重複的內容
|
||||
- 簡化冗長的描述和範例
|
||||
- 移除過度詳細的說明
|
||||
- 優化表格和列表結構
|
||||
|
||||
3. **品質保證**
|
||||
- 確保核心資訊完整保留
|
||||
- 維持文件的邏輯連貫性
|
||||
- 保持技術準確性
|
||||
- 確保可讀性和實用性
|
||||
|
||||
## 精簡原則
|
||||
|
||||
### 保留內容
|
||||
- 核心概念和定義
|
||||
- 關鍵步驟和流程
|
||||
- 重要的範例和用法
|
||||
- 必要的注意事項和警告
|
||||
- 核心配置和參數
|
||||
|
||||
### ✂️ 精簡內容
|
||||
- 重複的說明和範例
|
||||
- 過度詳細的背景描述
|
||||
- 冗長的介紹段落
|
||||
- 類似功能的重複說明
|
||||
- 過多的修飾性文字
|
||||
|
||||
### 🎯 優化策略
|
||||
- **合併相似章節**: 將功能相近的內容整合
|
||||
- **精簡範例**: 保留最具代表性的範例
|
||||
- **簡化表格**: 移除非必要的欄位和行
|
||||
- **優化格式**: 使用更緊湊的結構化格式
|
||||
|
||||
## 品質標準
|
||||
|
||||
精簡後的文件應該達到以下標準：
|
||||
|
||||
- **完整性**: 所有核心功能和概念都有涵蓋
|
||||
- **準確性**: 技術內容保持正確和最新
|
||||
- **實用性**: 讀者能夠快速找到需要的資訊
|
||||
- **簡潔性**: 內容長度減少 20-40%
|
||||
- **清晰性**: 結構邏輯清楚，易於理解
|
||||
|
||||
## 使用場景
|
||||
|
||||
- 技術文件過於冗長需要精簡
|
||||
- API 文檔需要提升可讀性
|
||||
- 使用手冊需要突出重點
|
||||
- 規範文件需要去除重複內容
|
||||
- 老舊文檔需要現代化整理
|
||||
|
||||
## 注意事項
|
||||
|
||||
**重要提醒**
|
||||
- 精簡過程中會保留所有關鍵資訊
|
||||
- 建議在執行前備份原始文件
|
||||
- 精簡後請檢查技術準確性
|
||||
- 考慮目標讀者的需求層次
|
||||
- 必須仔細分析思考，有時內容太少反而會造成誤會
|
||||
|
||||
## 輸出格式
|
||||
|
||||
精簡後的文件將：
|
||||
1. 保持原有的文件格式（Markdown/文本）
|
||||
2. 維持章節結構的邏輯性
|
||||
3. 標註精簡的主要變更點
|
||||
4. 提供精簡統計摘要
|
||||
102
commands/expand.md
Normal file
102
commands/expand.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
description: Document expand
|
||||
model: claude-sonnet-4-5
|
||||
---
|
||||
|
||||
將概要文件透過互動式詢問擴充為完整文件。
|
||||
|
||||
分析指定文件的大綱或概要內容，識別需要補充的細節，透過主動詢問和探索來擴充文件深度與廣度。
|
||||
|
||||
## 執行流程
|
||||
|
||||
1. **初步分析與規劃**
|
||||
- 掃描現有文件結構
|
||||
- 識別內容缺口和不明確處
|
||||
- 制定擴充策略和優先順序
|
||||
|
||||
2. **互動式探索**
|
||||
- 主動提出澄清問題
|
||||
- 詢問具體使用場景
|
||||
- 確認技術細節和邊界條件
|
||||
- 收集實際案例和最佳實踐
|
||||
|
||||
3. **智能擴充**
|
||||
- 根據回饋補充缺失內容
|
||||
- 添加範例程式碼和配置
|
||||
- 增加故障排除指南
|
||||
- 補充相關參考資源
|
||||
|
||||
## 擴充策略
|
||||
|
||||
### 探索領域
|
||||
- **概念定義**: 什麼是？為什麼重要？
|
||||
- **使用場景**: 何時使用？誰會使用？
|
||||
- **實作細節**: 如何運作？有哪些選項？
|
||||
- **最佳實踐**: 推薦做法？常見陷阱？
|
||||
- **相關資源**: 延伸閱讀？相關工具？
|
||||
|
||||
### 互動問題範例
|
||||
- "這個功能的主要使用者是誰？"
|
||||
- "有哪些常見的錯誤配置？"
|
||||
- "能否提供實際的使用案例？"
|
||||
- "這個流程的異常處理如何進行？"
|
||||
- "是否有性能或安全考量？"
|
||||
|
||||
### 內容補充重點
|
||||
- **前置條件**: 環境需求、相依性
|
||||
- **詳細步驟**: 完整操作流程
|
||||
- **程式範例**: 實際可執行的程式碼
|
||||
- **配置說明**: 參數詳解、預設值
|
||||
- **故障排除**: 常見問題與解法
|
||||
- **進階用法**: 客製化、整合方案
|
||||
|
||||
## 品質標準
|
||||
|
||||
擴充後的文件應達到：
|
||||
|
||||
- **完整性**: 涵蓋從入門到進階的完整知識
|
||||
- **實用性**: 包含可直接使用的範例
|
||||
- **可讀性**: 循序漸進的結構安排
|
||||
- **準確性**: 經過驗證的技術內容
|
||||
- **深度性**: 提供深入的技術洞察
|
||||
|
||||
## 使用場景
|
||||
|
||||
- 將簡要規格擴充為詳細文件
|
||||
- 補充 API 文件的使用範例
|
||||
- 完善安裝指南的故障排除
|
||||
- 擴充配置文件的參數說明
|
||||
- 豐富教學文件的實作細節
|
||||
|
||||
## 互動流程範例
|
||||
|
||||
```
|
||||
AI Assistant: 我注意到文件提到了「快取策略」但缺少具體實作。
|
||||
請問：
|
||||
1. 快取的過期時間是多久？
|
||||
2. 是否支援手動清除快取？
|
||||
3. 快取失效時的降級策略為何？
|
||||
|
||||
User: 快取24小時過期，支援 --no-cache 參數，失效時直接呼叫 API
|
||||
|
||||
AI Assistant: 了解！我會補充以下內容：
|
||||
- 快取生命週期管理
|
||||
- 清除快取的指令範例
|
||||
- API 降級的錯誤處理機制
|
||||
```
|
||||
|
||||
## 注意事項
|
||||
|
||||
**重要提醒**
|
||||
- 擴充過程可以多次詢問細節
|
||||
- 請準備相關技術規格和案例
|
||||
- 可隨時中斷並保存進度
|
||||
- 建議分階段進行大型文件擴充
|
||||
- 透過持續對話來確保文件的完整性和準確性
|
||||
|
||||
## 輸出格式
|
||||
|
||||
擴充後的文件將：
|
||||
1. 保持原始架構並新增章節
|
||||
2. 標註新增內容的來源依據
|
||||
3. 提供版本變更記錄
|
||||
98
commands/explain.md
Normal file
98
commands/explain.md
Normal file
@@ -0,0 +1,98 @@
|
||||
---
|
||||
description: 完整解釋技術概念、架構設計或流程
|
||||
model: claude-sonnet-4-5
|
||||
---
|
||||
|
||||
# 視覺化優先解釋模式
|
||||
|
||||
當我請你解釋技術概念、架構設計或流程時，請使用「視覺化優先」的解釋方式：
|
||||
|
||||
1. 不使用程式碼（除非我明確要求）
|
||||
2. 大量使用圖表、流程圖、表格來輔助說明
|
||||
3. 從高階概念逐步深入細節
|
||||
4. 用對比方式展示改進（現況 vs 建議）
|
||||
5. 提供實際案例和場景
|
||||
|
||||
請按照以下結構組織回答：
|
||||
|
||||
## 一、核心概念總覽
|
||||
|
||||
- 用一段話說明本質
|
||||
- 用簡單的圖表展示全貌
|
||||
|
||||
## 二、現況分析（如適用）
|
||||
|
||||
- 目前的做法/問題
|
||||
- 用圖表呈現現有架構
|
||||
|
||||
## 三、解決方案/概念詳解
|
||||
|
||||
- 核心想法的視覺化呈現
|
||||
- 各組件關係圖
|
||||
- 資料/流程走向
|
||||
|
||||
## 四、具體案例
|
||||
|
||||
- 用時間軸或流程圖展示實際運作
|
||||
- 標註關鍵決策點
|
||||
|
||||
## 五、優劣對比
|
||||
|
||||
- 用表格或對比圖展示優缺點
|
||||
- 說明適用場景
|
||||
|
||||
## 六、實施建議
|
||||
|
||||
- 分階段實施圖
|
||||
- 風險與注意事項
|
||||
|
||||
【視覺化工具】
|
||||
優先使用這些方式呈現：
|
||||
|
||||
1. **表格（最穩定）**：適合中文內容對比
|
||||
```
|
||||
┌──────┬──────┬──────┐
|
||||
│ 標題 │ 標題 │ 標題 │
|
||||
├──────┼──────┼──────┤
|
||||
│ 內容 │ 內容 │ 內容 │
|
||||
└──────┴──────┴──────┘
|
||||
```
|
||||
|
||||
2. **層級結構**：適合流程說明
|
||||
```
|
||||
主題
|
||||
├─ 子項目一
|
||||
│ └─ 細節
|
||||
└─ 子項目二
|
||||
└─ 細節
|
||||
```
|
||||
|
||||
3. **流程圖**：使用框線確保對齊
|
||||
```
|
||||
┌────┐ ┌────┐
|
||||
│開始│ ──→ │結束│
|
||||
└────┘ └────┘
|
||||
```
|
||||
|
||||
4. **對比圖**：使用分欄表格
|
||||
5. **關係圖**：簡化連線，重點在結構
|
||||
6. **時間軸**：垂直排列較穩定
|
||||
|
||||
圖表風格使用 Unicode 框線圖表，優先考慮排版穩定性：
|
||||
- 框線：┌─┬─┐ │ ├─┼─┤ └─┴─┘
|
||||
- 雙線框：╔═╦═╗ ║ ╠═╬═╣ ╚═╩═╝
|
||||
- 圓角框：╭─╮ │ ╰─╯
|
||||
- 箭頭：→ ← ↑ ↓ ⇒ ⇐
|
||||
- 分隔線：───── ═════ ━━━━━
|
||||
- 項目符號：• ▸ ▪ ◆
|
||||
|
||||
說明風格：
|
||||
- 每個圖表前後都要有文字說明
|
||||
- 複雜概念要分解成多個簡單部分
|
||||
- 用類比幫助理解（如適用）
|
||||
- 標註「為什麼」而不只是「是什麼」
|
||||
|
||||
記住：
|
||||
1. 目標是讓讀者快速理解概念和架構，而不是展示技術細節
|
||||
|
||||
think hard
|
||||
53
plugin.lock.json
Normal file
53
plugin.lock.json
Normal file
@@ -0,0 +1,53 @@
|
||||
{
|
||||
"$schema": "internal://schemas/plugin.lock.v1.json",
|
||||
"pluginId": "gh:MilesChou/claude-marketplace:plugins/document",
|
||||
"normalized": {
|
||||
"repo": null,
|
||||
"ref": "refs/tags/v20251128.0",
|
||||
"commit": "39b980b8afac2a166747ca0a7f2b752e7137768e",
|
||||
"treeHash": "ee1d64172253f71ded0aa0298fbd82d52c0656ea11f2647163ff2b1fff717d64",
|
||||
"generatedAt": "2025-11-28T10:12:07.344381Z",
|
||||
"toolVersion": "publish_plugins.py@0.2.0"
|
||||
},
|
||||
"origin": {
|
||||
"remote": "git@github.com:zhongweili/42plugin-data.git",
|
||||
"branch": "master",
|
||||
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
|
||||
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
|
||||
},
|
||||
"manifest": {
|
||||
"name": "document",
|
||||
"description": "Document tools",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"content": {
|
||||
"files": [
|
||||
{
|
||||
"path": "README.md",
|
||||
"sha256": "34cc2bab28d876df2563154d70935116206f150b999564b4f9b145d7aefd9141"
|
||||
},
|
||||
{
|
||||
"path": ".claude-plugin/plugin.json",
|
||||
"sha256": "70b58615889beae3a8a9a3783b775a0f4662b6146b76892d5938f70fb6f8b80e"
|
||||
},
|
||||
{
|
||||
"path": "commands/expand.md",
|
||||
"sha256": "ef219d8cb66d63ebaa2d21eea4e8328802859f4dc249ce23ae640a9478f9179c"
|
||||
},
|
||||
{
|
||||
"path": "commands/explain.md",
|
||||
"sha256": "36014f7b7af8d7c9bad66fac7234b47a6c59cce56c8a4512d4f5e7b8884244d8"
|
||||
},
|
||||
{
|
||||
"path": "commands/compact.md",
|
||||
"sha256": "27c303baa9b26203537735aa1dfd6a0ad9b01c8466a972e6d257ff9eae0ebbd8"
|
||||
}
|
||||
],
|
||||
"dirSha256": "ee1d64172253f71ded0aa0298fbd82d52c0656ea11f2647163ff2b1fff717d64"
|
||||
},
|
||||
"security": {
|
||||
"scannedAt": null,
|
||||
"scannerVersion": null,
|
||||
"flags": []
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user