用途
本技能定义 deepseek-harness 仓库中 PR 描述的内容、写法与更新时机。PR 模板只提供章节标题和占位符,各章节的具体要求由本技能规定。所有 PR 描述都遵循本技能,包括使用 gh pr create --body-file 跳过模板创建的 PR。
主要能力
- 规定描述结构:使用四个二级标题,顺序为
## Motivation、## Changes、## Testing、## AI Usage。固定章节标题与标签用英文,表格表头及其余描述用 PR 描述语言(默认中文,除非人工要求其他语言)。 - Motivation 要求:一句话说明问题,并至少引用一个同仓库 Issue(
Fixes #N、Closes #N、Resolves #N或Refs #N);PR 编号不算 Issue 引用。 - Changes 要求:分别总结接口变更(命令、标志、配置键、环境变量、公开导出、插件注册值、协议、持久化格式等,无则写 None)与行为变更(用户、模型、开发者或系统可观察的结果,无则写 None),只陈述 diff 保证且测试覆盖的行为。
- Testing 要求:先写测试设计,按变更类型选择形式(行为变更用场景×变更前×变更后×覆盖测试的行为矩阵;性能变更用各阶段前后值与测量条件;无行为变更的重构用逐字节对比或新旧对比;纯文档用链接、双语配对等检查方式);再逐条列测试记录,写明命令或步骤、覆盖行为、运行结果及证据来源(本地或 CI),可复核证据放入
<details><summary>Proof</summary>块。 - 变更特定披露:如修改现有测试描述的行为、提高
scripts/doc-budgets.manifest.json上限、修改用户可见 GUI 行为、使用术语表未收录的翻译词,需在相应章节以加粗英文标签写明规定内容。 - AI Usage:记录 AI 在各阶段的参与程度与决策者。级别从低到高为 hint 人工独立(0–10%)、assist 人工主导(15–25%)、pair 人工引导(30–50%)、copilot 人工把关(55–85%)、auto 模型自主(90–100%),另有 n/a 暂不适用。阶段固定为 breakdown 问题拆解、design 方案设计、testing 验收测试、implementation 技术实现、review 评审处理。
- 徽章与格式:AI-DECLARATION 块固定规范版本 0.1.2,按最高级别使用对应徽章 URL;表格每阶段一行,列为阶段、级别、AI 参与度、决策记录;决策记录用一两句话、最多 80 个汉字或 40 个英文词,写明谁做了哪些决策。
- 更新时机:创建 PR 时 review 行写 n/a 并说明尚未处理评审意见;PR 存在后描述不再匹配时重写受影响行以覆盖截至当前的全部工作,不追加变更历史;级别变化时更新对应行,最高级别变化时同步更新徽章与声明行;评审轮次在其修复推送且评论答复后结束,合并后到达的评论不触发更新。
使用方式
在创建 deepseek-harness PR 或在其后更新描述时应用本技能:按四章节结构撰写完整描述;创建时写全内容,之后当描述与 PR 不符时更新受影响章节;堆叠 PR 中每个 PR 有自己的描述,只覆盖该层相对其基分支的变更。依据会话记录与任务记录评定 AI Usage 各级别,记录充分时取满足标准的、人工参与最多的级别,并在该级别区间内按人工参与接近程度选择 AI 参与度数值。
适用场景
ddeepseek-harness 仓库中创建 PR、后续变更后更新描述、处理完一轮评审意见后更新描述。
限制
本技能仅适用于 deepseek-harness 的 PR 描述写作与维护,不涉及代码实现或其他仓库流程;内容依赖仓库内 Issue 管理、测试规则、术语表、record-browser-gif 等规则的配合;具体测量条件、证据内容需按实际运行结果填写,本技能不提供自动生成能力。