用途
platform-backend 面向服务端架构与安全,主要用于三类任务:构建 API、编写服务端逻辑、审查后端安全性。其范围包括 API 设计、错误处理、校验(validation)与日志记录(logging)。当用户的请求明确落在这一领域内时,应选用该技能并按其工作流执行。
主要能力
技能的核心是一组原则与规则:
- 原则一:使用守卫子句提前抛出错误——在函数顶部快速失败(fail fast)。
- 原则二:绝不静默吞掉错误——每一次失败都要被记录或向上传播。
更详细的模式规则收录在规则索引(rules index)中。技能本身不重复展开这些模式,而是指引使用者查阅对应索引。
使用方式
技能通过触发条件被选中。文档给出的示例包括:
- 正向触发:用户提出“为这个 API 端点设计错误处理与校验策略”,预期行为是使用 platform-backend 的指引,遵循其工作流,并返回可操作的输出。
- 非触发:用户提出“创建一个 Tailwind 设计令牌体系”,预期行为是不优先使用 platform-backend,而应选择更相关的技能或直接执行。
技能附带的工作流为:
- 判断请求是否明确匹配 platform-backend 的范围与触发条件。
- 应用技能规则与引用指引,产出具体结果。
- 依据约束校验输出质量;如果仍有缺口,在明确假设的前提下细化一次。
适用场景
适用于需要在服务端实现或审查中应用统一错误处理与校验约定的场合,例如设计某个 API 端点的错误处理与校验策略、编写服务端逻辑,或检查后端的安全实践是否到位。
限制与常见问题
文档列出了三类故障排查情形:
- 技能未被触发:预期选中但实际未选中。原因是请求措辞与描述中的触发条件不清晰匹配。解决办法是使用描述中明确的领域或任务关键词重述请求后重试。
- 与其他技能指引冲突:同一任务中多个技能给出冲突指令,原因是已加载技能的范围重叠。解决办法是指明当前步骤以哪个技能为权威,并优先应用该工作流。
- 输出过于笼统:结果缺少具体可操作的细节,原因是任务输入省略了上下文、约束或目标格式。解决办法是补充具体约束(环境、范围、格式、成功标准)后重新运行。
关于技能的安装命令、代码示例、收费方式或适用范围等具体信息,当前资料暂未提供。