spec: usk/3.0
id: data-analyst-secure-suite
version: 1.2.0
name: 資料分析師安全技能套件
description: 基於 MGC Blackbox 的資料分析安全工作流套件，提供憑據保護、零暴露指令碼應用、指令碼密封協作和知識管理。同時包含一個數據分析師 Agent 系統提示詞模板。
author: MirginCipher Team
license: MIT
tags: 安全, 資料分析, mgc, 零暴露, 本地沙箱, 憑據管理, 指令碼管理, 知識管理, Agent 模板, 模糊搜尋
platform_compatibility: windows, macos, linux
requires: mgc_blackbox: ">=1.4.10" changelog: - version: 1.2.0 changes: - 同步 MGC Blackbox 1.4.10：在 MCP 工具列表中新增 mgc_find（模糊搜尋）和 mgc_run（推薦代替 mgc_get action=run）。 - 指令碼管理：將示例中的 mgc_get(action='run') 替換為獨立的 mgc_run 工具。 - 指令碼管理：新增 mgc_find 模糊搜尋工作流。 - 指令碼密封：明確 ext04 必須是多行 PEM 公鑰。 - 憑據管理：新增 mgc_find 模糊搜尋工作流。 - 知識管理：新增 mgc_find 模糊搜尋工作流。 - Agent 系統提示詞：記錄 find -> get/run 工作流模式。 - version: 1.1.1 changes: - 根據評測報告最佳化文件結構 - 新增"反模式與陷阱"章節 - 新增"完整使用案例"章節 - 統一引用 prompts 檔名 - version: 1.1.0 changes: - 整合 prompts 結構為憑據管理、指令碼管理、知識管理三大核心模組 - 新增 agent_system_prompt.md 作為資料分析 Agent 系統提示詞模板 - 增強文件結構，明確各模組的適用場景與呼叫方式 - version: 1.0.0 changes: - 初始版本

概述

資料分析師安全技能套件是一個基於 MGC Blackbox 的文件技能套件，用於幫助資料分析師在本地安全地管理：

• 敏感憑據
• 使用者自有指令碼
• 跨團隊協作授權
• 分析框架與知識沉澱

本套件採用 混合形態設計：

• 技能提示詞（prompts/）：提供憑據管理、指令碼管理、知識管理三大核心能力
• Agent 系統提示詞模板（agent_system_prompt.md）：用於構建遵守嚴格安全邊界的資料分析 Agent

所有敏感操作均需使用者明確授權，本套件不提供任何自動化資料訪問能力。

適用場景

本技能套件適用於：

7w4.net小蔥技能站，你的AI助手技能庫。

• 企業內部資料分析
• 需要保護敏感資料的場景
• 需要安全共享指令碼的團隊協作
• 供應商指令碼的安全使用
• 構建安全資料分析 Agent
• 構建知識沉澱體系（可搭配 Self-Improving Agent）

前置條件

1. 安裝 MGC Blackbox（>=1.4.10）：
   pip install mgc-blackbox
2. 啟動 MGC 服務：
   mgc
3. MCP 工具可用：mgc_save, mgc_get, mgc_run, mgc_seal, mgc_list, mgc_find, mgc_open_webui
4. Token 檔案：~/.mgc/database/mgc_black_box/.mgc_token

核心能力

1. 憑據管理（credential_management.md）

用於安全管理資料庫金鑰、API Token 等敏感憑據。

適用場景

• 需要連線資料庫或外部服務
• 指令碼需要安全呼叫憑據
• 團隊成員需要共享訪問許可權（非共享資料）

能力說明

• 本地加密儲存
• AI 無法看到憑據內容
• 指令碼可零暴露呼叫憑據
• 所有訪問必須由使用者授權

Agent 如何使用

Agent 在使用者授權後可讀取憑據，但永不看到明文。

2. 指令碼管理（script_management.md）

用於管理使用者自有的查詢指令碼、清洗指令碼、分析指令碼等。

適用場景

• 使用者需要應用自己的指令碼
• 指令碼需要安全呼叫憑據
• 指令碼需要跨團隊協作（密封）
• 需要構建完整的資料分析鏈路（查詢 → 清洗 → 分析）

能力說明

• 指令碼加密儲存
• AI 不可見指令碼內容
• 指令碼可零暴露呼叫憑據
• 支援指令碼密封協作
• 所有應用必須由使用者授權

Agent 如何使用

Agent 在使用者授權後通過 MGC 應用指令碼，並可在多步驟工作流中逐步請求授權。

3. 知識管理（knowledge_management.md）

用於管理分析框架、提示詞模板、方法論、業務規則等知識資產。

適用場景

• 構建標準化分析框架
• 複用提示詞模板
• 團隊共享分析方法
• 構建知識沉澱體系
• 搭配 Self-Improving Agent 自動沉澱知識

能力說明

• 知識內容加密儲存
• AI 可在使用者授權後讀取知識
• 支援知識密封協作
• 可用於構建分析報告結構

Agent 如何使用

Agent 在使用者授權後可讀取知識，並用於指導分析結構或生成提示詞。

安全邊界

本技能套件提供

• 本地憑據加密儲存
• 使用者自有指令碼的零暴露應用
• 指令碼密封與協作授權
• 知識加密管理

本技能套件不提供

• 自動化資料訪問
• 自動化清洗或分析
• 自動化傳輸
• 指令碼生成或修改

所有指令碼必須由使用者提供並符合組織政策。

檔案結構

data-analyst-secure-suite/
├── SKILL.md                    # 主文件（本檔案）
├── README.md                   # 詳細使用說明
├── manifest.json               # 技能後設資料
├── agent_system_prompt.md      # Agent 系統提示詞模板
└── prompts/
    ├── credential_management.md    # 憑據管理
    ├── script_management.md        # 指令碼管理
    └── knowledge_management.md     # 知識管理

使用方式

方式一：作為技能使用（Skill Mode）

AI 可讀取 prompts/ 目錄中的三個核心文件：

AI 會根據使用者請求引用對應文件，並在每個敏感操作前請求授權。

方式二：作為 Agent 模板（Agent Mode）

將 agent_system_prompt.md 作為系統提示詞配置給 AI Agent。

Agent 將自動遵守以下安全邊界：

• 在每個敏感操作前請求使用者授權
• 僅通過 MGC Blackbox 應用指令碼
• 不得檢視指令碼內容或憑據
• 不得自動化執行工作流
• 不得自動選擇指令碼名稱（info_owner 必須由使用者提供）

Agent 可在使用者授權後引用 prompts/ 中的文件作為工作流指導。

MCP 工具參考

安全說明

1. 零暴露：指令碼與憑據在本地執行，AI 僅接收結果
2. 加密儲存：所有內容加密儲存
3. 無明文洩露：AI 永不看到指令碼或憑據內容
4. 指令碼密封：跨節點協作保持加密

聯絡方式

• 問題反饋：https://github.com/zkeviny/MGC-Blackbox/issues
• 郵箱：mirgincipher@outlook.com

提醒：本技能套件用於安全的工作流程管理。所有敏感操作必須獲得使用者明確授權。所有指令碼均為使用者自有，所有執行均在本地通過 MGC Blackbox 完成。

這是一個質量不錯的安全技能套件，專注於幫助資料分析師安全地管理指令碼和憑據。優點是文件清晰、使用案例豐富、安全設計合理，能有效防止敏感資訊洩露。不足是文件中存在一些引用錯誤和格式問題，可能給使用帶來困惑。整體值得推薦，但細節還需打磨。