技能 add-endpoint
📦

add-endpoint

內容修訂 r2 安全 ⚙️ 外部命令📁 檔案系統存取

新增 Catalyst-Relay API Endpoints

建立 Catalyst-Relay 路由需要一致的結構描述、處理常式、註冊與文件。此技能會引導 endpoint 結構、Hono wiring、response envelopes、client mapping 與文件撰寫。

支援: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 銅級

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求
Review the Skillstore skill "add-endpoint" from https://skillstore.io/skills/artisan-edge-add-endpoint.md and its manifest at https://skillstore.io/api/skills/artisan-edge-add-endpoint/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/artisan-edge-add-endpoint.md 已簽名 manifest GET /api/skills/artisan-edge-add-endpoint/manifest 已簽名 lockfile GET /api/skills/artisan-edge-add-endpoint/lockfile

測試它

正在使用「add-endpoint」。 新增具備 request validation 與 client method 的 login endpoint。

預期結果:

一份 route plan，涵蓋 route file、request schema、handler factory、Hono registration、ADTClient mapping、response envelope 與 documentation tasks。

正在使用「add-endpoint」。 新增 handler 後，為 packages endpoint 撰寫文件。

預期結果:

  • Endpoint description 與 request summary。
  • Request body 與 response field tables。
  • Error code list、use cases 與 library usage notes。

安全審計

安全
v9 • 2026/7/23 開啟版本化報告

All 19 static findings are false positives caused by Markdown code delimiters, inline code, a relative TypeScript import, and ordinary error text. The skill contains implementation guidance only, with no command execution, path traversal, reconnaissance, or prompt injection.

1
已掃描檔案
137
分析行數
0
複核項目
0
已忽略的誤報

風險因素

⚙️ 外部命令 (17)
SKILL.md:18 SKILL.md:20-60 SKILL.md:60-64 SKILL.md:64-66 SKILL.md:66-75 SKILL.md:75-81 SKILL.md:81-91 SKILL.md:91-93 SKILL.md:93-97 SKILL.md:97-101 SKILL.md:101 SKILL.md:102 SKILL.md:103 SKILL.md:107-112 SKILL.md:112-123 SKILL.md:123-127 SKILL.md:127-136
📁 檔案系統存取 (1)
SKILL.md:25
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/artisan-edge-add-endpoint/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/artisan-edge-add-endpoint/security.svg)](https://skillstore.io/skills/artisan-edge-add-endpoint?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/artisan-edge-add-endpoint?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/artisan-edge-add-endpoint/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/artisan-edge-add-endpoint.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
學術引用 (APA · BibTeX · CFF)

APA 引用

Artisan-Edge. (2026). add-endpoint security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/artisan-edge-add-endpoint/audits/9

BibTeX 引用

@techreport{artisan-edge-artisan-edge-add-endpoint-2026, author = {Artisan-Edge}, title = {add-endpoint security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/artisan-edge-add-endpoint/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "add-endpoint security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "Artisan-Edge" date-released: "2026-07-23" url: "https://skillstore.io/skills/artisan-edge-add-endpoint/audits/9" identifiers: - type: other value: "skillstore:artisan-edge-add-endpoint:audit:9" description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據 證據置信度: 高
55
架構
85
可維護性
87
內容
70
社群
83
規範符合度

你可以打造什麼

建立新的 API Route

新增具備 schema、handler、response type 與 route registration 的 Catalyst-Relay endpoint。

標準化 Endpoint 文件

準備包含 request details、response fields、errors、examples 與 use cases 的 endpoint docs。

對齊 HTTP 與 Library APIs

當 route 包裝可重用的核心功能時，將新的 endpoint 連接到 ADTClient method。

試試這些提示

新增基本 Endpoint 
使用 add-endpoint 規劃 [resource] 的新 endpoint。包含 route file、schema、handler、registration 與 docs checklist。
新增 Validation 與 Errors 
使用 add-endpoint 設計 [method] [path]。包含 required request fields、validation failures、success output 與 machine-readable error codes。
連接 Client Method 
使用 add-endpoint 新增 [method] [path] 並將它對應到 ADTClient method。包含 route wiring 與 documentation updates。
規劃多 Endpoint 功能 
使用 add-endpoint 規劃 [feature] 的相關 endpoints。分組 route files、shared schemas、client methods、error codes 與 docs sections。

最佳實務

  • 讓 schemas、response types 與 handlers 保持接近各自的 endpoint。
  • 每個 handler 都回傳一致的 success 與 error envelopes。
  • 在同一次變更中更新 route registration、client methods 與 docs。

避免

  • 新增 handler 但沒有 request validation。
  • 從不同 endpoints 回傳 ad hoc response shapes。
  • 變更 public API surface 後略過文件更新。

常見問題

此技能適用於哪些專案？
它適用於使用 TypeScript、Hono routes、Zod validation 與 ADTClient library mappings 的 Catalyst-Relay 專案。
它會自動產生 endpoint files 嗎？
不會。它提供可由 AI coding agent 或開發者套用到 repository 的實作指引。
它涵蓋 request validation 嗎？
會。它指示使用者將 Zod request schema 與每個 route handler colocate。
它包含 response conventions 嗎？
會。它記錄一致的 success envelope，以及具備 machine-readable code 的標準 error envelope。
我應該何時更新 ADTClient？
當 endpoint 包裝也應可在 library mode 中使用的可重用核心功能時，請更新 ADTClient。
應該新增哪些文件？
新增包含 request fields、response fields、examples、error codes、use cases 與 library usage notes 的 endpoint docs。

開發者詳細資訊

授權

MIT

Skillstore 修訂

r2

版本提示

作者未聲明版本。

儲存庫

https://github.com/Artisan-Edge/Catalyst-Relay/tree/main/.claude/skills/add-endpoint

引用

89edfdc710d0846129dcee6a929477b04f08052c

維護新鮮度

2026/7/26

使用量

7 次下載 · 210 次瀏覽

檔案結構

📄 SKILL.md

Artisan-Edge 的更多技能

查看全部

相關技能

查看全部