submit-feedback 是一套反馈提交工作流技能,来源于 vladm3105/aidoc-flow-framework 框架,当前页面是其 Muse 本地实例,采用与引擎无关的措辞,并维持独立性约定。
用途:当发现缺陷、文档错误或改进想法时,该技能用于将问题记录到所属仓库声明的待办或追踪系统中,确保其在发现它的会话结束后仍然可被他人或后续会话处理,而不是只留在对话、草稿、提交信息或会话交接材料里。
主要能力与流程:
- 确定权限与去向:读取当前仓库的 AGENTS.md 链路及相关治理约定,确定归属仓库、声明的待办或追踪系统、是否具有写入权限、必需的标签与问题模板,以及是否声明了优先级标签。仅在仓库说明或用户授权时才允许在当前仓库提交;写入其他仓库或外部系统需要明确授权。
- 提交门槛:当问题可被他人或后续会话处理、可在 file:line 复现且有可行的修复方向、或对用户可见或阻塞使用时才记录;不提交推测、已被当前改动修复的问题或重复项。
- 来源分类:每个问题必须标记为 real-use(项目在实际工作中遇到的故障,可指明具体的运行、PR、命令或使用方)或 review(审查、审计、扫描、自检或阅读过程中发现的问题)。来源分类是证据而非严重程度评级;real-use 在同队列中优先于 review。
- 提交前搜索:同时检索开放与关闭的 issue 和 pull request。已有匹配 issue 时补充评论;已关闭但复现的问题新建回归并交叉链接;已有修复 PR 时直接链接而非新建 issue。
- 正文结构:包含 Source(来源分类、来源项目、触发场景、阻塞情况)、Summary、Reproduction、Blast radius、Why diagnosis was difficult、Fix shape、What is not broken 等部分。
- GitHub 安全发布:使用 stdin 作为正文文件提交,不用字面正文参数;提交后回读正文长度确认发布成功;如仓库声明了优先级标签且已确认写入权限,可为 real-use 问题添加该标签并回读确认;升级已有 issue 的来源时仅改写 Origin 行,需先获取原正文。
- 报告:返回来源分类、来源项目、归属方、去向、issue 或条目标识及回读结果;若未获发布授权,则返回完整可提交的草稿并说明缺少的具体审批。
适用场景:适用于软件开发与维护过程中记录缺陷、文档错误和改进建议,尤其是需要将问题交接到所属仓库追踪系统的场景。
限制:写入其他仓库或外部系统需要明确授权,不能从共同归属、邻近检出或旧的人员名单推断权限;不创建第二套队列;不提交推测或重复项;具体仓库路径、授权细节和标签名称需以实际仓库声明为准,资料未提供具体项目的配置信息。