关于 platform-backend
platform-backend 是指导后端 API 开发的技能，强调尽早校验并抛出错误、避免静默吞错，并提供匹配请求、应用规则和检查结果的工作流。
主要功能
- 01使用守卫条件尽早失败
- 02记录或传播所有错误
- 03判断请求是否符合技能范围
- 04按工作流生成具体结果
- 05检查输出并在必要时修订
适用场景
- 01设计 API 端点的错误处理策略
- 02规划请求数据的校验方式
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/platform-backend确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/endpoint-blueprint.mdrules/_sections.mdapi-authorization-vs-authentication.mdapi-output-schemas.mdapi-request-lifecycle.mdapi-select-sensitive-fields.mderror-domain-specific.mderror-http-codes.mdlogging-structured.mdsecurity-dont-expose-internals.mdsecurity-dont-log-secrets.mdsecurity-filter-by-tenant.mdsecurity-never-commit-secrets.mdsecurity-procedure-hierarchy.mdvalidation-at-boundary.mdvalidation-strict-schemas.md详细介绍
原则
- 尽早使用守卫子句抛出错误——在函数开头快速失败
- 绝不默默吞掉错误——记录或传播每个故障
规则
详细模式请参阅规则索引。
示例
正向触发
用户：“为此 API 端点设计错误处理和验证策略。”
预期行为：使用 platform-backend 指南，遵循其工作流，并返回可执行的结果。
不触发
用户：“创建 Tailwind 设计令牌比例。”
预期行为：不要优先使用 platform-backend；选择更相关的技能，或不使用技能直接处理。
故障排除
技能未触发
- 错误：未按预期选择该技能。
- 原因：请求措辞与描述中的触发条件不够匹配。
- 解决方案：使用描述中的明确领域或任务关键词重新表述，然后重试。
指南与其他技能冲突
- 错误：多个技能的指令在同一任务中发生冲突。
- 原因：已加载技能的适用范围重叠。
- 解决方案：说明当前步骤以哪个技能为准，并优先应用其工作流。
输出过于笼统
- 错误：结果缺少具体、可执行的细节。
- 原因：任务输入未提供上下文、限制或目标格式。
- 解决方案：补充具体限制（环境、范围、格式、成功标准），然后重新运行。
工作流
- 判断请求是否明确符合
platform-backend的适用范围和触发条件。 - 应用技能规则和引用的指南，生成具体结果。
- 根据限制检查输出质量；若仍有不足，则在明确假设后再完善一次。
评论
支持 Markdown