Repository navigation
v2.4.1 — 🔧 对齐修复:让「承诺」与「实现」一致(无新增模式)
🔧 对齐修复:让「承诺」与「实现」一致(无新增模式)
本版不写新内容,只修 v2.4.0 之前遗留的「说的和做的不一致」。起因是一次外部代码审查——审计脚本可以被 13 个空文件刷到 86 分,而 main 的 CI 从 2026-09-30 起一直是红的。
cli/hpp.pyinit不再用 cwd/home 路径白名单:该白名单把/tmp挡死(CI 冒烟脚本正好写/tmp),是 CI 连续两次失败的根因;同时它也不提供真实防护。改为「不跟随 symlink + 不覆盖已有内容 + 不删除任何东西」。顺带修三个同类问题:~未展开(README 的~/my-agent在 Windows 上会建出字面量~目录)、已存在空目录无法初始化(WinError 183)、目标为文件时抛未捕获NotADirectoryError。scripts/validate_state.py接受 Markdown 列表前缀:v2.4.0 的「安全加固」把幂等键正则改成行首锚定,结果拒绝了仓库自带的示例(- 2026-06-29: article: uuid-a1b2c3)。这正是skill-evolution里「旧成功仍然成立」那条被自己违反的实例。同时Lessons Learned改为「章节必须存在、内容可为空」(新任务尚无经验可写)。- 两个 starter kit 的 STATE.md 补齐缺失章节(
basic-agent缺Idempotency Keys,两者均缺Lessons Learned),cron-production的幂等键从表格改为与templates/STATE.md.template一致的列表格式——一个契约,不再各写各的。 scripts/run_regression.py→scripts/check_test_suite.py:它从来不跑任何 prompt,只校验 JSON 字段齐全。改名后报告口径同步改为schema-valid,并显式标注「未执行行为验证」。徽章从Regression 36/36 Pass改为Test suite 36 schema-valid。顺带删掉Patterns covered这个指标——它用id.rsplit("-", 1)猜模式名,36 条算出 36 个「模式」,是假的。- CI 新增
state-contractjob:对templates/、examples/、starter-kits/下每个 STATE.md 逐一校验,README 里「CI 自动运行 STATE 校验」这句话从此为真(此前为假)。regression-testjob 更名为test-suite-schema。 - 新增
.gitattributes(* text=auto eol=lf):修 Windows 检出(autocrlf)后lint.js把全部 21 篇公约误判为「无 frontmatter」的根因,也让后续跨平台工具行为一致。 - 文档数字对齐:21 个公约(原写 20)、anti-patterns 13 条(原写 8 种);
package.json版本2.01.00(非法 semver)→2.4.1。
已知未修(下一阶段):hpp audit 仍只按文件名匹配证据、密钥扫描仍整行锚定、lint.js 在 CRLF 下仍会误判并可能写坏文件、check_maturity.py 仍有 6 条恒真项。详见审查报告的 P0-2/P0-3/P1-6/P1-7。