AGENT SKILL
migrate-to-shoehorn
将测试文件从 `as` 类型断言迁移到 @total-typescript/shoehorn。当用户提到 shoehorn、想要在测试中替换 `as`、或需要部分测试数据时使用。
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 541
- Forks
- 48
01 前言 Front Matter
- name
- migrate-to-shoehorn
- description
- 将测试文件从 `as` 类型断言迁移到 @total-typescript/shoehorn。当用户提到 shoehorn、想要在测试中替换 `as`、或需要部分测试数据时使用。
02 资源文件 1
- 参考文档agents/openai.yaml104 B
03 SKILL.md 正文
迁移到 Shoehorn
为什么使用 shoehorn?
shoehorn 让你在测试中传递部分数据,同时保持 TypeScript 类型正确。它用类型安全的替代方案取代了 as 断言。
仅限测试代码。 切勿在生产代码中使用 shoehorn。
as 在测试中的问题:
- 习惯上被训练不要使用它
- 必须手动指定目标类型
- 双重
as(as unknown as Type)用于传递故意错误的数据
安装
npm i @total-typescript/shoehorn
迁移模式
大型对象,只用到少数属性
迁移前:
type Request = {
body: { id: string };
headers: Record<string, string>;
cookies: Record<string, string>;
// ...还有 20 个属性
};
it("gets user by id", () => {
// 只关心 body.id,但必须伪造整个 Request
getUser({
body: { id: "123" },
headers: {},
cookies: {},
// ...伪造所有 20 个属性
});
});
迁移后:
import { fromPartial } from "@total-typescript/shoehorn";
it("gets user by id", () => {
getUser(
fromPartial({
body: { id: "123" },
}),
);
});
as Type → fromPartial()
迁移前:
getUser({ body: { id: "123" } } as Request);
迁移后:
import { fromPartial } from "@total-typescript/shoehorn";
getUser(fromPartial({ body: { id: "123" } }));
as unknown as Type → fromAny()
迁移前:
getUser({ body: { id: 123 } } as unknown as Request); // 故意传错类型
迁移后:
import { fromAny } from "@total-typescript/shoehorn";
getUser(fromAny({ body: { id: 123 } }));
各函数的适用场景
| 函数 | 使用场景 |
|---|---|
fromPartial() |
传递部分数据,仍能通过类型检查 |
fromAny() |
传递故意错误的数据(保留自动补全) |
fromExact() |
强制传入完整对象(后续可替换为 fromPartial) |
工作流程
-
收集需求 — 询问用户:
- 哪些测试文件中的
as断言造成了问题? - 是否涉及大型对象,只有部分属性是重要的?
- 是否需要传递故意错误的数据用于错误测试?
- 哪些测试文件中的
-
安装并迁移:
- [ ] 安装:
npm i @total-typescript/shoehorn - [ ] 查找含有
as断言的测试文件:grep -r " as [A-Z]" --include="*.test.ts" --include="*.spec.ts" - [ ] 将
as Type替换为fromPartial() - [ ] 将
as unknown as Type替换为fromAny() - [ ] 从
@total-typescript/shoehorn添加 import - [ ] 运行类型检查以验证
- [ ] 安装:
04 同仓库更多 Skills
writing-for-agents
为智能体编写文档。当你正在创建或编辑技能,或者修改 AGENTS.md / CLAUDE.md 时使用。
★ 541
wait-what
等等。上一条消息我没理解:重新解释一下。
★ 541
to-questionnaire
将你无法完全回答的决策转化为供他人填写的问卷。
★ 541
teach
在当前工作区中教会用户一项新技能或概念。
★ 541
handoff
将当前对话压缩为一份交接文档,供另一个智能体继续工作。
★ 541
grilling
对用户的计划、决策或想法进行层层盘问。当用户想要压力测试自己的思考,或使用任何 'grill' 触发短语时使用。
★ 541