关于 faasjs-utils-data
面向 FaasJS 开发的技能，指导选择和使用数据工具，涵盖 JSON、YAML、数据校验与路径检查。还说明了工具变更的针对性测试和交付检查。
主要功能
- 01便携式工具选择指南
- 02JSON 解析与流处理配对
- 03YAML 解析与配置加载
- 04Zod 校验与类型守卫
- 05根目录范围内的路径检查
- 06针对性测试与代码检查
适用场景
- 01为 JSON 或文本载荷选择工具
- 02解析 YAML 或分阶段加载 FaasJS 配置
- 03校验外部数据和未知值
- 04在 Node 侧访问文件前检查路径
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/faasjs-utils-data确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/guidelines/json.mdutils.mdvalid.mdyaml.md详细介绍
FaasJS 工具与数据
默认工作流
- 使用与负载形状匹配的最小辅助工具。
- JSON 辅助工具配合 JSON 负载使用，文本辅助工具配合文本流使用。
- 使用 Zod schema 验证外部数据，使用辅助类型守卫检查未知的内部值。
- 直接解析 YAML 时使用
parseYaml()；需要分阶段发现 FaasJS 配置时使用loadConfig()。 - 在 Node 端工具中访问文件前，先验证路径是否位于根目录范围内。
加载以下参考资料
- 可移植辅助工具和快速选择规则：
references/guidelines/utils.md。 - JSON 解析和 JSON 流辅助工具：
references/guidelines/json.md。 - 直接解析 YAML：
references/guidelines/yaml.md。 - Zod 辅助工具、对象收窄、schema 解析和路径包含性：
references/guidelines/valid.md。
注意事项
- 不要用 Zod schema 替代内部控制流检查。
objectToStream与streamToObject配套使用；stringToStream与streamToString配套使用。- 配置暂存和合并顺序很重要时，使用
loadConfig()，而不是直接解析 YAML。
验证
- 修改辅助工具行为后，使用
vp test <pattern>运行针对性单元测试。 - 修改工具文件后，交接前运行
vp check --fix。
评论
支持 Markdown