用途:指导 AI 智能体在编写 Salesforce GraphQL 查询前,先探索当前 org 的 GraphQL schema,避免凭假设使用字段。schema 反映 org 当前状态,自定义对象与字段需先部署元数据才会出现。
主要能力与用法:schema 文件位于 SFDX 项目根目录的 schema.graphql(不在 webapp 目录内),所有 grep 命令须在项目根目录执行。若文件缺失,需在 webapp 目录(force-app/main/default/webapplications/<app-name>/)运行 npm run graphql:schema 下载,等待成功后再继续。每次元数据部署后应重新运行 npm run graphql:schema 与 npm run graphql:codegen 保持类型与查询同步。
允许的查找仅限 grep,且需带 -n、-E、锚点 ^、词边界 \b 与最小 -A 上下文:查字段用 grep -nE '^type[[:space:]]+Account[[:space:]]+implements[[:space:]]+Record\b' ./schema.graphql -A 60;查过滤用 ^input Account_Filter;查排序用 ^input Account_OrderBy;查变更用 Account.*(Create|Update|Delete);查输入类型用 ^input AccountCreateInput。入口为 Query { uiapi } 与 Mutation { uiapi(input: ...) },记录查询用 uiapi.query.<ObjectName>。
限制:禁止用编辑器、cat/less/more/head/tail、node/python/awk/sed/jq 或流式分页读取该文件;字段名区分大小写,须以 grep 结果为准。自定义对象与字段以 __c 结尾。生成查询可参考 generating-graphql-read-query 与 generating-graphql-mutation-query 技能。