antithesis-skills-feedback

Antithesis Skills 反馈

技能版本： 2026-10-21 4f8d80b

帮助用户通过打开预先填写好的 GitHub issue，针对 Antithesis skills 提交错误报告。

基础 URL

https://github.com/antithesishq/antithesis-skills/issues/new?template=bug_report.yml

通过 URL 参数预填写字段

GitHub issue 模板支持使用查询参数预填写字段。每个参数键都对应模板中某个字段的 id。将参数以 &<id>=<value> 的形式追加，参数值必须经过百分号编码（空格 → %20，换行 → %0A 等）。

可用字段如下：

参数	类型	填写内容
what-happened	textarea	简要总结出了什么问题。控制在 1-2 句话，用户会进一步补充。
expected	textarea	留空——只有用户知道他们预期的结果。
skill	input	当时启用的技能（例如 antithesis-triage、antithesis-setup）。
skill-version	input	运行 git -C <skills-repo> rev-parse --short HEAD 以获取提交 SHA。
agent	input	Agent 名称和版本（例如 Claude Code 1.0.20）。使用上下文中可用的 Agent 信息。
agent-explanation	textarea	诚实地自我评估：你做了什么，以及问题为何发生？最多 2-4 句话。
context	textarea	留空——用户可以自行添加截图和日志。

也可以通过 title=<value> 参数设置 issue 的 title。

如何构建 URL

1. 确定问题发生时正在使用的技能。
2. 如果知道 skills 仓库的位置，在其中运行 git rev-parse --short HEAD 以获取技能版本。
3. 从环境上下文中确定 Agent 信息（Agent 名称和版本）。
4. 撰写简短的 what-happened 摘要（1-2 句话）。
5. 撰写 agent-explanation——简短、诚实地自我评估出了什么问题（2-4 句话）。
6. 将 title 设为对错误的简短描述（少于 80 个字符）。
7. 对所有参数值进行百分号编码。
8. 拼接 URL，只追加你能有意义地填写的字段。不要填写 expected 或 context——这些留给用户填写。

URL 长度限制

URL 总长度不得超过 2000 个字符。 浏览器和 GitHub 可能会截断或拒绝更长的 URL。如果 URL 超过此限制：

• 优先缩短 what-happened 和 agent-explanation——用户可以在表单中编辑。
• 如果仍然过长，则完全移除 agent-explanation。
• 最后才移除 what-happened，仅预填写 skill、skill-version、agent 和 title。

URL 示例

https://github.com/antithesishq/antithesis-skills/issues/new?template=bug_report.yml&title=Triage%20skill%20fails%20to%20parse%20property%20results&skill=antithesis-triage&skill-version=1c45cd3&agent=Claude%20Code%201.0.20&what-happened=The%20triage%20skill%20crashed%20while%20parsing%20property%20results%20from%20the%20Antithesis%20dashboard.&agent-explanation=I%20attempted%20to%20extract%20property%20data%20from%20the%20results%20page%20but%20the%20HTML%20structure%20did%20not%20match%20the%20expected%20selectors.

呈现给用户

不要自动提交 issue。 打开 URL（如果没有可用浏览器，则打印 URL），以便用户查看预填写的字段、在 expected 和 context 中补充自己的信息，并在准备好后提交。