用途:为 Remix 的某项变更创建或修订 GitHub 跟踪 issue,形成聚焦的交接文档,说明必须改什么、如何判定完成,而不把 issue 写成规定性的实现规范。
主要能力:使用 gh 进行 GitHub 读写;先检查相关代码、包元数据、文档与现有测试,确认当前状态和受影响边界;记录用户已做的决策,不重新讨论或弱化;从 git remote 确认目标仓库,搜索重复 issue,必要时查看 issue 模板或标签;按结构起草 issue,省略无价值章节;创建或编辑后用 gh 读回,核对标题、正文、状态与 URL。
issue 结构:标题要具体命名结果与受影响区域;摘要说明当前问题、期望终态与变更意义;上下文与需求给出非显而易见的事实,如所有权边界、必须保留的公共 API/命令/包导出、兼容与迁移预期、依赖方向约束、不得改变的默认行为、明确的非目标;实现计划为单一扁平复选框列表,每项一句话,覆盖实现、集成、测试、文档、打包与发布说明,描述要达成的结果而非编辑顺序或内部设计;必需门禁用普通项目符号列出验收标准,不用复选框;附加上下文仅在确有帮助时加入迁移示例、发布影响等。
使用方式:创建或编辑 issue 属于外部写入,仅在用户要求创建或更新时执行,否则返回草稿。
限制:需求保持语义层面,避免锁定具体类型形状、辅助函数名、文件布局或解析实现,除非仓库或用户已决定;不使用嵌套复选框、逐文件配方、提议接口或逐命令指令;不因标签存在就添加,只使用准确传达仓库工作流或所有权的标签;不把历史变更日志与无关清理纳入范围,除非被要求;不因聚焦的跟踪 issue 而创建通用抽象,除非变更本身需要。