用途
该技能适用于创建、更新或审阅 eve 仓库的拉取请求,以及向评审者解释分支变更。
工作流程
先检查分支差异、提交、关联议题或讨论、测试、文档与变更集。更新已有拉取请求时,先阅读现有正文,再填写仓库的拉取请求模板。
写作规则
摘要通常用一个短段落,约两到四句、不超过约一百个英文单词。先写具体问题、用户需求或决策原因,再说明解决方案及重要行为。不同要点拆句,使用主动语态,一句只讲一个主题;必要的术语、专有名称和代码标识保留。
在适用处遵循 ASD-STE100:描述句不超过二十五词,步骤句不超过二十词,并使用含义明确的词。不要按文件罗列改动或复述提交过程;仅在有助于判断行为和风险时解释实现细节。
有关破坏性变更、取舍、范围和后续工作,只写对评审有意义的内容。已有议题或讨论时附上关联,不为拉取请求单独制造议题。验证部分只记录实际运行的检查、失败与限制,保留检查清单且只勾选已确认项目。
发布方式与限制
发布前确认摘要首先说明变更为什么必要。正文先保存为文件,再交给 GitHub CLI 的创建或编辑命令使用。该技能提供说明写作规范,不替代代码评审和测试。