Agent Skill Kit Ask

🚀 Agent-Skill-Kit (ASK) v2.0

Agent-Skill-Kit (ASK) v2.0 是一個面向 AI 智能體的本地優先技能框架。它無需 API 密鑰、無需註冊，零摩擦使用。具備原生智能體支持、MCP 就緒的特性，讓你可以輕鬆克隆、運行和集成。

🚀 快速開始

30 秒快速上手

# 從 GitHub 安裝
pip install git+https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git

# 查看可用技能  
ask dashboard

# 運行技能
ask run tech-pulse
ask run repo-visualizer
ask run architect "Your idea"

就是這麼簡單！無需 .env 文件，無需尋找 API 密鑰，也無需 OAuth 重定向。

✨ 主要特性

V2.0 特性

🔌 MCP 服務器集成

技能現在通過 core/mcp_gateway.py 作為原生 MCP 工具公開。Claude 和 Copilot 可以直接發現並執行技能，無需自定義集成。

# Claude 現在可以將所有技能視為原生工具
python core/mcp_gateway.py

🏗️ 架構師技能

根據自然語言描述生成新技能。架構師可以立即創建 Python 腳本骨架和 YAML 清單。

ask run architect "Convert CSV to JSON format"

💫 動態 README

GitHub Actions 每 24 小時自動運行 Tech-Pulse 並更新此 README 的“今日智能體情報”部分，證明該倉庫是活躍且功能正常的。

🎨 高端終端 UI

增強的 TUI 具備以下特點：

• ASCII 藝術橫幅 (ASK-2026)
• 系統健康儀表盤
• 即時進度顯示
• 專業的彩色輸出

🖥️ 桌面 GUI 應用程序 (新增!)

現代 PyQt6 桌面界面，具有以下功能：

• 技能瀏覽器 - 搜索和過濾所有可用技能
• 可視化執行器 - 通過漂亮的表單輸入執行技能
• 即時輸出 - 即時查看技能執行情況
• 歷史記錄跟蹤 - 查看過去的技能執行記錄
• 儀表盤 - 查看系統統計信息和技能類別
• 專業設計 - 精緻的原生桌面應用程序體驗

使用 ask-gui 啟動。

🎯 四個零配置技能

1. 倉庫可視化器 📊

立即生成項目結構的 Mermaid.js 類圖。

ask run repo-visualizer /path/to/project

輸出：一個乾淨的 Mermaid 圖，可直接粘貼到文檔中或提供給 AI 智能體。

graph TD
    Root["MyProject"]
    Root --> skills["📁 skills"]
    Root --> core["📁 core"]
    skills --> visualizer["📁 repo-visualizer"]

2. 智能體身份 🎭

使用免費的 DiceBear API 為你的項目生成一個獨特的 SVG 頭像。

ask run agent-identity "Agent-Skill-Kit"

輸出：一個漂亮的、確定性的 SVG 頭像，保存到磁盤並顯示。

<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
  <!-- Unique avatar based on project name -->
</svg>

3. 科技脈搏 🔥

從 HackerNews 獲取前 5 條熱門科技故事，讓你的 AI 智能體保持對最新信息的瞭解。

ask run tech-pulse

輸出：Markdown 格式的故事，包含鏈接、分數和評論數量。

#1. Breakthrough in AI Reasoning Model
- 🔗 URL: https://news.ycombinator.com/item/...
- 👤 Author: username
- 📈 Score: 1,234 | 💬 Comments: 456

4. 架構師 🏗️

新增！ 根據描述生成新技能。架構師會自動創建起始模板。

ask run architect "Analyze code complexity"

輸出：一個完整的技能目錄，包含 script.py 和 manifest.yaml。

📦 安裝指南

你可以根據自己的需求選擇以下安裝選項：

選項 1：pip 包 - 推薦（適用於所有環境）

適合所有用戶（Windows、Mac、Linux）

# 從 GitHub 安裝
pip install git+https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git

# 或者從 wheel 文件安裝
pip install agent_skill_kit-2.0.0-py3-none-any.whl

# 然後使用全局命令
ask dashboard
ask run tech-pulse
ask run repo-visualizer

選項 2：源碼安裝 - 適合貢獻者

適合開發者、自定義和貢獻代碼

git clone https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git
cd Agent-Skill-Kit-ASK-
pip install -e .

# 使用全局命令
ask dashboard
ask run architect "Convert CSV to JSON"

選項 3：桌面 GUI - 現代界面

適合喜歡可視化操作、無需命令行的用戶

# 安裝支持 GUI 的版本
pip install git+https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git

# 啟動漂亮的桌面應用程序
ask-gui

這將打開一個專業的 PyQt6 桌面應用程序，具有以下特點：

• 🎨 現代、直觀的界面
• 🔍 技能瀏覽器和搜索功能
• 📊 即時執行儀表盤
• 📜 執行歷史記錄跟蹤
• ⚡ 一鍵執行技能並帶有參數表單

瞭解更多關於 GUI 的信息 →

選項 4：直接運行源碼 - 無需安裝

適合快速測試和試用

git clone https://github.com/HughKnightOCE/Agent-Skill-Kit-ASK-.git
cd Agent-Skill-Kit-ASK-

# 通過 CLI 直接運行
ask dashboard
ask run tech-pulse
ask run architect "Your skill description"

# 或者啟動 GUI（需要 PyQt6）
pip install PyQt6
ask-gui

選項 5：獨立可執行文件 - 零依賴

適合沒有安裝 Python 或需要便攜使用的用戶 從 Releases 下載預構建的可執行文件：

• Windows：ask-gui.exe - 雙擊運行
• macOS：ask-gui - 從終端運行
• Linux：ask-gui - 從終端運行

無需安裝 Python！

Windows 命令提示符故障排除

如果 ask 在命令提示符 (cmd) 中無法工作，可以使用以下替代方法： 選項 A：使用 PowerShell 替代（推薦）

ask dashboard
ask run tech-pulse
ask-gui  # GUI 在 PowerShell 中也能很好地工作

選項 B：直接使用 Python（適用於所有環境）

python -m core.ask dashboard
python -m core.ask run tech-pulse

選項 C：手動將腳本添加到 PATH

setx PATH "%PATH%;%APPDATA%\Python\Python314\Scripts"

然後重新啟動命令提示符，再次嘗試 ask。

📚 詳細文檔

哲學理念：原生智能體 + MCP 就緒

ASK 是專門為 AI 智能體構建的。每個技能輸出以下內容：

1. 乾淨的 Markdown（AI 可讀格式）
2. 結構化數據（JSON、YAML 註釋）
3. 最小化干擾（無交互式提示）
4. 錯誤處理（優雅失敗）

適用場景：

• 🤖 Claude Code - MCP 集成，實現原生技能訪問
• 🧠 GitHub Copilot CLI - 自定義 MCP 命令
• 🔧 自定義智能體 - 通過動態技能生成進行擴展
• 📡 大語言模型鏈 - 無需外部 API 的多步驟工作流
• 🏗️ AI 框架 - 為任何智能體提供即插即用的 MCP 服務器

CLI 管理器：ask (2026 版)

具有 ASK-2026 樣式和即時顯示的高性能 TUI。

# 帶有系統健康信息的儀表盤 (新增!)
ask dashboard

# 運行技能並顯示即時進度
ask run <skill-name> [args...]

# 系統診斷
ask doctor

# 幫助信息
ask help

特性：

• ✨ ASCII 藝術橫幅 (ASK-2026)
• 📊 系統健康儀表盤（Python 版本、Git 狀態、依賴項）
• 🎬 即時進度旋轉器
• 🎨 專業的彩色輸出

MCP 服務器集成 (新增!)

將所有技能作為原生 MCP 工具公開：

from core.mcp_gateway import SkillMCPServer

# Claude、Copilot 和其他智能體將技能視為原生工具
server = SkillMCPServer()
await server.run()

Claude 現在可以：

用戶: "使用倉庫可視化器工具分析我的項目"
Claude: [通過 MCP 調用倉庫可視化器] → 查看完整輸出

架構師：生成新技能 (新增!)

立即將想法轉化為技能：

# 根據自然語言創建
ask run architect "Convert YAML to JSON"

# 輸出:
# ✅ Created: skills/convert-yaml-to-json/
# ✅ Created: script.py
# ✅ Created: manifest.yaml
# 🚀 Next: Edit and run your new skill!

動態 README (新增!)

此 README 每 24 小時通過 GitHub Actions 自動更新熱門科技情報。“今日智能體情報”部分證明 ASK：

• ✅ 活躍且功能正常
• ✅ 運行真實工作流
• ✅ 連接真實數據
• ✅ 達到生產級別

CLI 管理器：ask.py

由 rich 驅動的受 Rust 啟發的 TUI。

項目結構

Agent-Skill-Kit/
├── core/
│   └── ask.py                 # ⭐ 主 CLI 管理器
├── skills/
│   ├── repo-visualizer/
│   │   ├── script.py          # 實現代碼
│   │   └── manifest.yaml      # 元數據
│   ├── agent-identity/
│   │   ├── script.py
│   │   └── manifest.yaml
│   └── tech-pulse/
│       ├── script.py
│       └── manifest.yaml
├── README.md                  # 你正在查看的文件
├── requirements.txt           # 依賴項
└── .github/
    └── workflows/             # CI/CD (可選)

依賴項

最小化且輕量級：

PyYAML>=6.0        # 用於清單解析
rich>=12.0         # 用於漂亮的 CLI

安裝方法：

pip install -r requirements.txt

貢獻：添加你自己的技能

ASK 設計為支持社區貢獻。創建一個技能只需要 5 分鐘。

技能模板

每個技能需要：

1. script.py - 邏輯代碼
2. manifest.yaml - 元數據

步驟 1：創建技能目錄

mkdir -p skills/my-awesome-skill
cd skills/my-awesome-skill

步驟 2：編寫 script.py

#!/usr/bin/env python3
"""My awesome skill that does X without any API key."""

def main(arg1, arg2=None):
    """Main execution function."""
    print("🎉 My skill output")
    print("✅ Ready for AI agents!")

if __name__ == "__main__":
    import sys
    arg1 = sys.argv[1] if len(sys.argv) > 1 else "default"
    main(arg1)

步驟 3：編寫 manifest.yaml

name: My Awesome Skill
version: "1.0.0"
description: "Does X without requiring any API keys"

author: "Your Name"
category: "utility"

requirements:
  - name: "python"
    version: ">=3.8"

api_keys_required: false
dependencies: []

usage:
  command: "python script.py"
  args_required:
    - name: "arg1"
      description: "Description of argument"

output_format: "markdown"

tags:
  - "keyless"
  - "local"

步驟 4：測試技能

python ../core/ask.py dashboard
python ../core/ask.py run my-awesome-skill

步驟 5：提交 PR

我們歡迎貢獻！提交 PR 時請包含：

• ✅ 可正常工作的技能代碼
• ✅ 正確的 manifest.yaml
• ✅ 描述中的使用示例
• ✅ 無需外部 API 密鑰

使用案例

個人開發者

# 早晨例行：編碼時查看科技新聞
python ask.py run tech-pulse

# 可視化代碼庫以用於文檔編寫
python ask.py run repo-visualizer

AI 智能體（Claude Code、Copilot CLI）

# 在智能體流程中
subprocess.run(["python", "ask.py", "run", "repo-visualizer"])
# 解析 Mermaid 輸出並提供給大語言模型

團隊

# 新成員入職：生成項目概述
python ask.py run repo-visualizer /monorepo/service-a

# 團隊品牌建設：創建一致的頭像
python ask.py run agent-identity "TeamName"

安全與隱私

✅ 所有處理都在本地進行 - 除 API 調用外，沒有數據離開你的機器
✅ 無需身份驗證 - 無需管理憑證
✅ 開源 - 查看代碼，審核邏輯
✅ 最小化依賴項 - 代碼越少，風險越低

路線圖

• [ ] 更多技能：
  • code-metrics：分析代碼複雜度
  • dependency-graph：可視化包依賴關係
  • api-docs-generator：自動生成 OpenAPI 規範
• [ ] 技能市場：發現社區技能
• [ ] 技能模板：一鍵生成技能
• [ ] 智能體集成：官方 Claude Code 插件
• [ ] 性能優化：API 調用緩存層

故障排除

"ImportError: No module named 'rich'"

pip install rich pyyaml

"Skill not found"

ask dashboard  # 檢查已安裝的技能

"API call failed"

一些免費 API 有速率限制。請在幾秒鐘後重試。

📄 許可證

本項目採用 MIT 許可證，可自由使用、修改和分發。

🌟 支持我們

• ⭐ 給這個倉庫加星，如果你覺得它有用
• 🔗 與其他構建 AI 工具的開發者分享
• 📝 為社區貢獻技能
• 💬 提出功能請求和問題

🤖 開發者為智能體打造

Agent-Skill-Kit 基於這樣的信念構建：AI 智能體應該擁有強大的本地工具，而無需 OAuth、API 密鑰和註冊的繁瑣流程。

無論你是在構建個人自動化工具、團隊助手，還是與 Claude Code 集成，ASK 都是你實現本地智能的零摩擦網關。

為 AI 原生未來用心打造 ❤️

█████████████████████████████████████████████████████
█ Agent-Skill-Kit: Local Power. Zero Keys. Pure Joy. █
█████████████████████████████████████████████████████