SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场submit-learnings

submit-learnings

测试与质量

查看项目

更新于 10-16 10:19

技能介绍

用途

submit-learnings 是一个 QA 反馈协调类技能，目标是帮助用户把 QA 会话中产生的有价值现场观察，以结构化的 GitHub issue 形式提交给插件维护者。它充当用户与插件仓库之间的反馈汇总入口。

主要能力

  • 读取当前项目目录下的 .qa-learnings/ledger.md 台账文件，若文件不存在或仅有标题行（# QA Learnings Ledger），则提示尚未记录任何 learnings 并要求先运行 QA 会话。
  • 按 ## 标题切分台账条目，逐条解析：时间戳、来源（agent 或 skill 名称）、观察内容（正文）、以及以 Suggested change: 开头的建议改动行。
  • 将全部条目按来源分组并编号展示，便于用户挑选。
  • 支持多种选择方式：按编号（如 "1,3,5"）、按来源（如 "smoke-tester"）、或选择 "all"。
  • 将选中的观察格式化为 GitHub issue 正文，包含条目数量、来源、日期范围、提交者（通过 gh api user --jq .login 获取）以及按来源分组的观察明细与建议改动。
  • 在终端预览完整 issue 正文，等待用户确认或修改。
  • 提交 issue 到 neonwatty/qa-skills 仓库，标题格式为 learnings: [N] observations from [sources]，并附加 learnings 标签；若标签不存在则先创建（描述为 "Field observations from QA sessions"，颜色 0E8A16），再重试创建。
  • 可选地创建配套 PR：fork 仓库、克隆到临时目录、创建 learnings/[short-slug] 分支、应用建议改动并提交，最后创建引用该 issue 的 PR。

使用方式

该技能通过对话式流程分阶段执行：加载与解析、筛选、草拟 issue、提交 issue、可选 PR、反思。

在筛选阶段，技能会先输出类似以下的清单：

Found [N] learnings from [M] sources:

smoke-tester (3 entries)

  1. [2026-04-01] Cookie not checked after login redirect
  2. [2026-04-02] /dashboard 500 not caught by status check
  3. [2026-04-03] Auth flow timing out on slow connections

ux-auditor (2 entries)

  1. [2026-04-01] Missing empty state not flagged
  2. [2026-04-02] Spacing check too strict on mobile viewports

随后询问要包含哪些观察，并等待用户选择后再继续。

提交 issue 时执行：

gh issue create --repo neonwatty/qa-skills --title "[constructed title]" --body "[approved body]" --label "learnings"

若标签不存在则先执行：

gh label create learnings --repo neonwatty/qa-skills --description "Field observations from QA sessions" --color "0E8A16"

提交后显示 issue URL。

可选 PR 阶段会询问用户是否附带建议改动的 PR，若同意则执行 fork、克隆、建分支、应用改动、推送并创建 PR，PR 标题格式为 fix(qa): apply learnings — [short description]，正文引用对应 issue 编号，最后显示 PR URL。

适用场景

  • QA 会话中由各 agent 和 skill 自动记录了大量观察，需要人工筛选后集中反馈给插件维护者。
  • 希望把现场发现的问题与改进建议以规范格式提交到上游仓库。
  • 希望在提交 issue 的同时附带具体改动 PR，加快改进落地。

限制与注意事项

  • 依赖 GitHub CLI（gh）及其登录与仓库操作权限（创建 issue、fork、创建 PR 等）。
  • 依赖项目目录中存在 .qa-learnings/ledger.md 台账文件；无记录时无法继续。
  • 应用建议改动的 PR 流程中，仅修改克隆出的 fork 目录内文件，不编辑用户项目中的文件。
  • 提交前需要用户在终端预览并确认，且用户需自行排除与插件无关的项目特定内容。
  • 技能最后会读取 references/reflection-protocol.md 并执行。

暂未提供的信息

关于收费、价格、支持平台与效果指标等信息，资料中暂未提供。