SuperAPI AI 工具集

typescript-report-issue

编程与开发

查看项目

更新于 11-12 16:34

技能介绍

typescript-report-issue 是微软 TypeScript 技能集中的一个技能,Skill 版本为 1.0,调用方式为 /typescript-report-issue。其用途是帮助用户向 microsoft/TypeScript 问题跟踪器提交缺陷报告。

使用流程方面,技能首先要求用户用自己的话描述想要报告的 bug,并按需追问,直到明确下一步。在正式处理前,需要查阅 TypeScript FAQ、tsc 安全属性、CONTRIBUTING.md 等文档,并搜索是否已存在可能重复的 issue;如果问题似乎已被上述材料覆盖,则与用户商量后续做法。否则,先与用户确认将要进行的调查类型,然后让用户选择:审阅一份 Markdown 草稿文件,或者直接发布到 microsoft/TypeScript 问题跟踪器。

报告模板要求包含以下部分:TypeScript 版本(如有必要可补充操作系统、编辑器或包管理器信息);用户目标(说明人类发起该流程的意图,例如想提交 PR、想通过找 bug 锻炼、遇到问题需要缩小范围等);设置与操作(尽量提供零依赖、单文件、最小复杂度且保留可读标识符的最小示例,若涉及多个文件可征得用户同意后发布样例仓库;操作指运行 tsc、在编辑器中执行某动作或检查输出文件等,编辑器 bug 应使用人类在编辑器中的操作动词来描述);预期与实际行为(若实际行为是崩溃或挂起则无需额外说明,否则建议简要说明);代理信息(注明 harness 版本、模型和 Skill Version 1.0)。

写作上强调尽可能简洁,简短直接的报告最受 TypeScript 团队欢迎,不要描述“不是什么”,避免多余内容。不应包含根因分析(除非有合理理由且特别相关,如性能问题附带了 profile)以及建议的修复方案。

适用场景包括:用户遇到疑似 TypeScript 缺陷希望规范化上报;代理在代码检查或版本对比中发现潜在问题;用户想为项目提交 PR 而先定位问题等。限制方面,资料未提供收费、价格、平台兼容性等额外信息。