適用可執行 shell 的 Agent
Agent Skill
可攜式指引套件內含獨立 CLI,為 Agent 提供工作流程、安全規則與 Public V1 API 直接存取能力,不需要 MCP runtime。
適合 Codex、Claude Code、OpenCode 與其他可執行本機命令的 Agent。
兩種介面,同一份 契約
選擇 Agent 已理解的介面。API 行為與權限模型始終一致。
適用 MCP client
MCP 伺服器
已發布的伺服器提供具輸入驗證的結構化工具。Client 可探索可用操作,並透過 MCP protocol 呼叫。
適合原生支援 MCP 的桌面助理與 Agent host。
相同的 source of truth
兩種介面使用同一個 Public V1 API client、Bearer authentication、scoped abilities 與標準化錯誤。
讓 Agent 完成整套 工作流程
從檢索走到可長期保存的知識,不必逐一教每個 Agent 如何操作 API。
帶著脈絡檢索
進行語意檢索、查看命中的 chunk,回答前再開啟來源文件。
保存有價值的成果
將會議回顧、研究筆記或 session 摘要儲存為草稿,留待人工審閱。
維持知識有序
建立資料夾與標籤、合併重複項目,讓文件持續容易被找到。
審慎處理檔案與分享
上傳與下載檔案、檢查分享狀態,並只在明確要求下進行敏感變更。
讓 Agent 引導你完成 安裝
只要貼上一段簡短 Prompt,Agent 就能判斷適合的介面並逐步引導,同時避免暴露 API 金鑰。
請你的 Agent 安裝 MarkNest
Prompt 會指向最新的機器可讀指南,安裝細節更新時,頁面仍能保持簡潔。
Help me install MarkNest for this agent.
Read https://marknest.net/llms.txt and follow the Agent Integration guide...
展開完整 Prompt 收合完整 Prompt
Help me install MarkNest for this agent.
Read https://marknest.net/llms.txt and follow the Agent Integration guide...Help me install MarkNest for this agent.
Read https://marknest.net/llms.txt and follow the Agent Integration guide.
First determine whether this client supports Skills or MCP, then ask which operating system I use.
Guide me one step at a time. Keep my API key private, ask before changing configuration files, and finish with a read-only verification.從 API 金鑰到第一次 請求
建立具權限範圍的金鑰,安裝符合 Agent 的介面,啟用寫入前先執行一次真實讀取。
- 1
- 2
安裝所需介面
下載並驗證 Skill ZIP,再將其中的 marknest 資料夾解壓縮至 Agent 的 skill directory。若使用 MCP,則將 npm server 加入 client config。
- 3
用讀取操作驗證
先列出文件或執行語意檢索。只有工作流程需要時才加入寫入權限。
安裝 Skill bundle 0.2.0
curl -LO https://marknest.net/downloads/marknest-skill-0.2.0.zip
curl -LO https://marknest.net/downloads/marknest-skill-0.2.0.zip.sha256
shasum -a 256 -c marknest-skill-0.2.0.zip.sha256
unzip marknest-skill-0.2.0.zip -d <agent-skill-directory> Skill CLI 範例 Skill
export MARKNEST_API_KEY="mk_your_api_key"
node scripts/marknest.mjs search semantic \
--query "launch notes"
node scripts/marknest.mjs documents create \
--title "Launch recap" \
--content "# Launch recap" \
--status draft MCP client config MCP
{
"mcpServers": {
"marknest": {
"command": "npx",
"args": ["-y", "@marknest/mcp-server@0.2.0"],
"env": {
"MARKNEST_API_KEY": "mk_your_api_key"
}
}
}
}預設實用,變更時保持 謹慎
整合層會區分日常讀取,以及可能公開、覆寫或刪除知識的操作。
安全讀取
提出結論或修改建議前,先搜尋並檢查上下文。
先寫成草稿
只要工作流程允許,新的摘要與筆記會預設保存為可審閱的草稿。
確認敏感操作
刪除、公開分享與類似覆寫的更新都需要明確的使用者意圖。