用途:Sharp Edges 是 agent-studio 的“活目录”,记录已确认的危险模式(hazard patterns),每条对应一个实际发布过的 bug。在调试和代码审查开始时调用,用症状对照已知失败模式。
主要能力:收录 SE-01 至 SE-07 七条条目,每条包含症状、根因、修复方式、测试断言和受影响文件。SE-01 Windows 反斜杠路径:path.relative() 在 Windows 返回反斜杠,glob 模式用正斜杠,需先归一化。SE-02 JSON.parse 原型污染:使用 safeParseJSON 剥离 proto、constructor、prototype 键。SE-03 钩子退出码协议:0 允许、2 阻止,process.exit(1) 或 process.exit(true) 无效。SE-04 Promise.all 异步异常吞没:改用 Promise.allSettled 获取部分结果。SE-05 glob 转正则的 ReDoS:避免嵌套量词,使用 [^/]* 等线性模式。SE-06 夏令时算术错误:不要用毫秒加法,改用 setDate 等日期运算。SE-07 遍历中修改数组:先收集变更再统一应用,或遍历副本。
使用方式:在调试会话开始时调用 Skill({ skill: 'sharp-edges' }),再将症状与 SE-01 至 SE-07 匹配。若发现新的可复现缺陷,可按固定格式(标题、症状、根因、修复、测试断言、受影响文件)追加条目。
记忆协议:开始前读取 .claude/context/memory/learnings.md;完成后将新模式写入 learnings.md,问题写入 issues.md,决策写入 decisions.md。
适用场景:agent-studio 项目内的调试、代码审查与缺陷预防。
限制:条目仅针对 agent-studio 特定环境,其他项目需自行验证;资料未提供安装方式、收费、平台支持范围等信息。