技能 add-endpoint
📦

add-endpoint

内容修订 r2 安全 ⚙️ 外部命令📁 文件系统访问

添加 Catalyst-Relay API 端点

创建 Catalyst-Relay 路由需要一致的 schema、handler、注册和文档。此技能指导端点结构、Hono 接线、响应封装、客户端映射和文档编写。

支持: Claude Codex Code(CC)
🥉 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”。 添加一个带请求验证和客户端方法的登录端点。

预期结果:

一份路由计划，涵盖路由文件、请求 schema、handler 工厂、Hono 注册、ADTClient 映射、响应封装和文档任务。

正在使用“add-endpoint”。 在添加 handler 后记录 packages 端点。

预期结果:

  • 端点描述和请求摘要。
  • 请求体和响应字段表。
  • 错误代码列表、用例和库使用说明。

安全审计

安全
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 路由

添加带有 schema、handler、响应类型和路由注册的 Catalyst-Relay 端点。

标准化端点文档

准备包含请求详情、响应字段、错误、示例和用例的端点文档。

对齐 HTTP 和库 API

当路由封装可复用的核心功能时，将新端点连接到 ADTClient 方法。

试试这些提示

添加基础端点 
Use add-endpoint to plan a new endpoint for [resource]. Include the route file, schema, handler, registration, and docs checklist.
添加验证和错误 
Use add-endpoint to design [method] [path]. Include required request fields, validation failures, success output, and machine-readable error codes.
连接客户端方法 
Use add-endpoint to add [method] [path] and map it to an ADTClient method. Include route wiring and documentation updates.
规划多端点功能 
Use add-endpoint to plan related endpoints for [feature]. Group route files, shared schemas, client methods, error codes, and docs sections.

最佳实践

  • 让 schema、响应类型和 handler 靠近各自的端点。
  • 从每个 handler 返回一致的成功和错误封装。
  • 在同一次变更中更新路由注册、客户端方法和文档。

避免

  • 添加没有请求验证的 handler。
  • 从不同端点返回临时拼凑的响应结构。
  • 更改公共 API 表面后跳过文档。

常见问题

此技能适用于哪些项目？
它适用于使用 TypeScript、Hono routes、Zod validation 和 ADTClient 库映射的 Catalyst-Relay 项目。
它会自动生成端点文件吗？
不会。它提供实现指导，供 AI coding agent 或开发者在仓库中应用。
它涵盖请求验证吗？
会。它指导用户将 Zod request schema 与每个 route handler 共置。
它包含响应约定吗？
会。它记录一致的成功封装，以及带有机器可读 code 的标准错误封装。
我什么时候应该更新 ADTClient？
当端点封装了可复用的核心功能，并且该功能也应在库模式中可用时，请更新 ADTClient。
应该添加哪些文档？
添加端点文档，包括请求字段、响应字段、示例、错误代码、用例和库使用说明。

开发者详情

许可证

MIT

Skillstore 修订

r2

版本提示

作者未声明版本。

仓库

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

引用

89edfdc710d0846129dcee6a929477b04f08052c

维护新鲜度

2026/7/29

使用量

7 次下载 · 210 次浏览

文件结构

📄 SKILL.md

Artisan-Edge 的更多技能

查看全部

相关技能

查看全部