技能 sop-api-development
📦
sop-api-development
內容修訂 r1 安全 ⚙️ 外部命令
協調 REST API 交付
建置生產環境用的 REST API 需要讓需求、實作、測試、文件與部署保持一致。此技能提供一套為期兩週的 TDD 工作流程，用於協調專門代理。
支援: Claude Codex Code(CC)
使用我的智慧代理安裝
將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。
智能體請求
Review the Skillstore skill "sop-api-development" from https://skillstore.io/skills/dnyoussef-sop-api-development.md and its manifest at https://skillstore.io/api/skills/dnyoussef-sop-api-development/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。
測試它
正在使用「sop-api-development」。 規劃一個具備驗證與角色權限的使用者管理 REST API。
預期結果:
一份分階段交付計畫，包含需求、OpenAPI 設計、資料庫結構描述、TDD 任務、測試範圍、文件與部署檢查。
正在使用「sop-api-development」。 協調已在預備環境中的 API 生產環境準備事項。
預期結果:
一份上線檢查清單，涵蓋最終驗證、煙霧測試、監控、回滾、流量切換、文件更新與支援交接。
正在使用「sop-api-development」。 定義新端點群組的測試涵蓋範圍。
預期結果:
一份測試計畫，涵蓋單元、整合、E2E、效能、安全性、邊界案例與驗收條件。
安全審計
安全v8 • 2026/7/5 開啟版本化報告
Static external-command findings are false positives from Markdown JavaScript examples and template string delimiters. The blocker findings are ordinary REST API terms such as endpoint IDs, delete operations, invalid input, and OpenAPI compliance. No evidence of prompt injection, malware intent, data exfiltration, or unauthorized reconnaissance was found.
1
已掃描檔案
548
分析行數
0
複核項目
0
已忽略的誤報
風險因素
⚙️ 外部命令 (50)
SKILL.md:26-28 SKILL.md:37-40 SKILL.md:52-55 SKILL.md:67-68 SKILL.md:68-72 SKILL.md:72-74 SKILL.md:87-90 SKILL.md:99-100 SKILL.md:100-117 SKILL.md:117-127 SKILL.md:136-138 SKILL.md:147-149 SKILL.md:158-160 SKILL.md:160-166 SKILL.md:166-170 SKILL.md:185-188 SKILL.md:202-205 SKILL.md:216-219 SKILL.md:219-225 SKILL.md:225-227 SKILL.md:235-237 SKILL.md:246-248 SKILL.md:256-258 SKILL.md:266-268 SKILL.md:268-283 SKILL.md:283-285 SKILL.md:293-295 SKILL.md:304-306 SKILL.md:316-318 SKILL.md:318-324 SKILL.md:324-326 SKILL.md:337-339 SKILL.md:348-350 SKILL.md:360-362 SKILL.md:362-378 SKILL.md:378-380 SKILL.md:393-396 SKILL.md:404-407 SKILL.md:416-417 SKILL.md:417-421 SKILL.md:421-423 SKILL.md:432-435 SKILL.md:445-446 SKILL.md:446-450 SKILL.md:450-452 SKILL.md:461-464 SKILL.md:472-473 SKILL.md:473-531 SKILL.md:531-536 SKILL.md:540-541
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/dnyoussef-sop-api-development/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/dnyoussef-sop-api-development?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/dnyoussef-sop-api-development?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/dnyoussef-sop-api-development/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/dnyoussef-sop-api-development.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 引用
DNYoussef. (2026). sop-api-development security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/dnyoussef-sop-api-development/audits/8BibTeX 引用
@techreport{dnyoussef-dnyoussef-sop-api-development-2026,
author = {DNYoussef},
title = {sop-api-development security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/dnyoussef-sop-api-development/audits/8},
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: "sop-api-development security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "DNYoussef"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/dnyoussef-sop-api-development/audits/8"
identifiers:
- type: other
value: "skillstore:dnyoussef-sop-api-development:audit:8"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高 55
架構
85
可維護性
87
內容
71
社群
78
規範符合度
你可以打造什麼
規劃新的 API 建置
將 API 構想轉換為分階段的需求、架構、資料庫、測試與 DevOps 工作流。
協調後端交付
引導實作團隊完成 TDD 端點開發、審查、文件與發布準備。
準備上線營運
在上線前建立預備環境、生產環境、監控、回滾、runbook 與支援交接步驟。
試試這些提示
開始 API 計畫
Use this REST API SOP to plan a new API for my product. Ask for missing requirements before assigning workstreams.
建立交付階段
Apply the two-week SOP to my API project. Produce phase goals, agent responsibilities, deliverables, and review checkpoints.
執行 TDD 端點工作
Use the SOP to coordinate TDD delivery for these endpoints. Include tests, implementation tasks, reviews, and documentation outputs.
準備生產環境發布
Use the deployment and validation sections to prepare staging, production rollout, monitoring, rollback, and knowledge transfer plans.
最佳實務
- 在實作開始前確認需求、資料模型與驗證規則。
- 在端點實作前先撰寫測試，並讓審查輸出與每個端點保持對應。
- 在生產環境流量移轉前驗證預備環境、回滾、監控與文件。
避免
- 在 API 合約與資料庫結構描述審查完成前就開始後端實作。
- 未經人工安全性與營運審查，就將產生的任務視為生產環境核准。
- 未依專案限制調整，就使用預設時程或效能目標。
常見問題
這個技能會自動建置 API 程式碼嗎？
不會。它提供結構化工作流程與任務提示，用於協調 API 交付。
它針對哪一種 API 風格？
它針對 REST API，包含 OpenAPI 文件、資料庫設計、TDD 與分階段部署。
我可以搭配 Claude、Codex 或 Claude Code 使用它嗎？
可以。marketplace metadata 將 Claude、Codex 與 Claude Code 列為支援工具。
它包含安全性測試嗎？
有。它包含 OWASP API 檢查、注入測試、授權檢查與速率限制驗證。
兩週時程可以變更嗎？
可以。將時程視為規劃基準，並依範圍、團隊規模與風險調整。
團隊在使用它之前應該準備什麼？
準備產品目標、初始端點構想、目標技術堆疊、部署環境與可用的代理角色。