diff --git a/system/agents/coder-methodology-trial/.claude/skills/skills.md b/system/agents/coder-methodology-trial/.claude/skills/skills.md new file mode 100644 index 0000000..16e459d --- /dev/null +++ b/system/agents/coder-methodology-trial/.claude/skills/skills.md @@ -0,0 +1,8 @@ +# 我的技能 + +## 技能清单 +- main_skill — coder 执行质量操作手册(把prd/sdd/acceptance规格可靠转成能通过验收的可运行代码,见根目录 `SKILL.md`) + +## 说明 +- 每个技能是 skills/ 目录下的一个子文件夹 +- 每个技能文件夹内必须包含 SKILL.md 定义文件 diff --git a/system/agents/coder-methodology-trial/SKILL.md b/system/agents/coder-methodology-trial/SKILL.md new file mode 100644 index 0000000..c8b3a5a --- /dev/null +++ b/system/agents/coder-methodology-trial/SKILL.md @@ -0,0 +1,186 @@ +# SKILL.md — coder / org-coder 执行质量操作手册 v2 + +> 训练对象:`coder`(及 org 版 `org-coder`)四段式生命周期(RESEARCH/PLAN/EXECUTE/VERIFY) +> 判据来源:`train/digest/benchmark_v1.md`(6 维度,D1/D5 封顶) +> 定位:这不是 benchmark 的复述,是"照做就能拿高分"的操作清单。每条都配一个可以直接执行的 +> 机械动作,不是一句原则性的话。看不懂"怎么做"就说明这条没写到位,回来改。 +> 不改变 `coder/agent.md` 的硬约束 1-7 和四段式产出物形态——本手册是在硬约束之上补"做得 +> 够不够格"这一层,硬约束仍以 `agent.md` 原文为准。 +> v1→v2 修订:EXECUTE 阶段机械动作由"清单B命中/不命中"两支判断改为三支判断,新增 +> "SDD未提及但未禁止"分支强制留痕(关闭 D5 5分档"未提及或明确禁止"并列要求里被 v1 漏掉的 +> 前半句),详见 `train/evolve/iteration_log.md` Round 2。 + +--- + +## 开工前必读:两张清单,RESEARCH 阶段建好,全程带着走 + +在 RESEARCH 阶段读完 prd/sdd/acceptance 之后,**在 `_research.md` 里追加两张表**(不是额外文件, +就是现有 RESEARCH 产出物里的一节),后面 PLAN/EXECUTE/VERIFY 全程对着这两张表走,不要凭记忆判断。 + +### 清单 A:SDD 接口契约锚点表(服务 D4) + +逐条过 SDD,把每一处"技术落点"分到两栏: + +| 类型 | 判据 | 处理方式 | +|---|---|---| +| **锚点**(必须逐字/逐值对齐) | 数值型规格(px/颜色值/断点/字号/间距/比例)、无障碍属性(`aria-*`/`role`)、被测试脚本/下游节点引用的 selector/id/事件名/API 字段名 | 实现时逐值照抄;如果因为客观原因做不到(比如平台限制),必须停下写 `blocked`,不许悄悄改数值 | +| **内部命名**(允许自由发挥) | 没被声明为下游消费对象的纯内部 class 名/变量名 | 允许换名字,但换了之后 `coder.log` 要有一句"此项非接口契约,采用等效实现:SDD 写的是 X,我用了 Y,理由是……" | + +机械动作:**扫描 SDD 全文里出现的每一个具体标识符/数值,逐条填进这张表,扫完为止**——用"扫完了" +而不是"我觉得重要的都记了"作为完成判据(借用 prd-planning 训练"描述性语言扫描"的思路,见 +`train/hunt/knowhow_v1.md` 2.3 节)。 + +**边界提醒(独立样本 `p-v82tpc` 发现的真实缺口,暂未收窄为硬规则,需要评分者/coder 自行留意)**: +HTML 顶层容器标签本身的语义变化(如 `
`→`