关于 expo-skill-feedback
expo-skill-feedback 是用于提交 Expo 产品和文档反馈的 Agent 技能,也可识别适合作为评测案例的任务失败。反馈与可选使用遥测相互独立,提交失败报告前需要获得用户批准。
主要功能
- 01按类别提交 Expo 反馈
- 02添加主题说明背景
- 03识别适合作为评测的任务失败
- 04提交评测报告前征求批准
- 05查看或控制可选遥测
适用场景
- 01报告过时的技能说明
- 02反馈 Expo CLI 命令问题
- 03将 Agent 任务失败记录为评测候选
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ expo/ skills --skill expo-skill-feedback安装后在 Claude Code 中输入/expo-skill-feedback确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlscripts/skill-event.cjstelemetry_common.cjstelemetry.cjs详细介绍
Expo 技能反馈
分享具体反馈,帮助 Expo 改进,说明哪些方面效果良好,或有哪些不足。提交反馈与使用情况遥测相互独立,也不需要启用遥测。
提交反馈
npx --yes submit-expo-feedback@latest "<ACTIONABLE_FEEDBACK>"
在能提供有用背景信息时,可单独添加以下任一可选标志:
npx --yes submit-expo-feedback@latest --category "<CATEGORY>" --subject "<SUBJECT>" "<ACTIONABLE_FEEDBACK>"
--category 默认为 unknown;如果没有具体目标,可以省略 --subject。
填写这些参数时,请选择最准确地标明反馈内容的值:
| 类别 | 主题 |
|---|---|
skills | frontmatter 中的确切技能名称,例如 expo-router |
docs | 完整的 Expo 文档 URL |
mcp | 使用的确切 MCP 工具名称 |
expo-cli | 完整的 Expo CLI 命令,例如 npx expo install |
eas-cli | 完整的 EAS CLI 命令,例如 eas build |
evals | 失败任务涉及的 Expo 包或命令;如果不适用,则填写能力短语,例如 expo-router 或 eas build |
unknown | 简洁的 Expo 产品、包、功能或其他主题 |
在最后一个参数中,说明哪些内容有帮助以及原因,或者提供相关背景、预期行为和实际发生的情况。请勿包含机密信息、源代码、个人数据、长篇提示词或堆栈跟踪。
Eval 候选:导致模型失败的任务
Expo 会将真实世界中的难题转化为 Agent 评测:Agent 能尝试的任何任务——框架、EAS、工具——无论是否涉及技能,都符合条件。值得提交的情况是:AI Agent 尽了实际努力仍无法顺利完成任务,例如多次尝试失败、构建或屏幕始终无法正常工作,或用户不得不手动介入修复。请勿提交 Agent 自行纠正的短暂失误、每次会话提交多个候选任务,或已报告过的任务。
发生此类失败时,或用户表示模型未能完成 Expo 任务时,请向用户展示你打算提交的确切内容并征得同意;Task 字段必须描述任务的 Expo 技术特征,绝不能描述用户的产品或业务背景。如果没有用户批准(无头模式或 CI 运行),请勿提交。然后在失败应用的目录中运行(CLI 会自动附加 SDK 和包版本、Agent 测试框架及平台信息),并使用 --category evals、以所涉及的 Expo 包或命令命名的 --subject(只有在没有单一适用包时才使用能力短语),以及最后一个参数中的以下结构:
Task: <what was asked, self-contained>.
Expected: <observable success criteria>.
Actual: <what the agent did instead>.
Wrong approach: <the specific mistake, such as a wrong API, hallucinated prop, or bad pattern>.
Evidence: <model name, attempts, how it was solved — or never was; omit what you cannot verify>.
好的候选任务应当可解决(最终已完成或明确可行)、可验证(成功与否可观察)且具体。只提及 CLI 无法看到的环境细节,例如其他关键包或刚创建的应用。描述代码即可,不要粘贴代码。如果命令报错,指出 evals 是无效类别,请改用 --category unknown 重发一次,并在同一 subject 前加上 eval-candidate: ;如果遇到其他错误,则不要重发。
使用情况遥测
自动技能使用情况遥测独立于反馈,且默认关闭。未经用户明确请求,绝不启用。使用以下脚本并添加 --on、--off 或 --status:
node "${CLAUDE_PLUGIN_ROOT}/skills/expo-skill-feedback/scripts/telemetry.cjs" --status
对应的环境变量为:使用 EXPO_SKILLS_TELEMETRY=1 启用,使用 EXPO_SKILLS_TELEMETRY=0 或 DO_NOT_TRACK=1 禁用。CI 永远不会发送遥测数据。
提交反馈
如果你在此技能中发现错误、误导性或过时的信息,请报告,以便 Expo 改进:
npx --yes submit-expo-feedback@latest --category skills --subject "expo-skill-feedback" "<actionable feedback>"
只有在有具体且可操作的内容时才提交。请尽可能提供相关背景信息。 如果 AI Agent 反复失败,或用户不得不接手 Expo 任务,请加载 expo-skill-feedback 技能,并按照其 eval 候选流程操作,而不是重复使用上面的命令。