用途:在 easy-cheese 仓库内编写、编辑、重构或审查 Python 代码,产出满足请求且符合仓库约定、尽可能小且可读的改动。
主要能力与规则:以 Python 3.12 为目标,直接使用其语言与类型特性,不为旧版本添加兼容代码;运行时以标准库为默认依赖预算,第三方运行时依赖须为纯 Python 并登记到 requirements/runtime.txt,新依赖需显式决策。代码放置于所属包并保持 bundle 边界,技能运行时位于 src/easy_cheese/skills/<skill_name>/,CLI 在 commands.py 中声明。
边界与数据:在边界处一次性校验不可信输入,随后使用带类型的可信数据;用标准库解析器解析文本,检查容器形状、必需键和值类型并在边界抛出具体错误;需要时转换为冻结数据类或领域值类型,TypedDict 仅用于必须保持映射的场景。完整注解函数和公共方法边界。
使用方式:按顺序阅读根配置、所属技能、目标导出、直接调用方和附近约定;类型检查使用 basedpyright(缺失时回退 uvx basedpyright),运行针对性测试,重新构建受影响的 bundle,最后运行 just check。归档变更后运行 just wedge-build,验证用 just wedge-check。
限制与要求:不要手工编辑 skills/<skill>/scripts/<skill>.pyz;不要添加或镜像到已发布 skills/ 树或 agents/openai.yaml;不用裸 except 或吞掉 Exception;新顶层函数保持 40 行以内;基于 basedpyright 的报告,变更文件须零错误零警告;测试须密闭,文件系统测试限于临时目录。