社区收录 技能
DESIGN.md Skills
google-labs-code/design.md 仓库中的 AI Agent Skills 套件，包含 CLI agent 友好度评估（Agent DX CLI Scale）、终端 UI 渲染（@json-render/ink）、TypeScript TDD 工作流（Red-Green-Refactor）和类型安全服务契约（Typed Service Contracts）四个独立 skill。
社区收录技能包clitddtestingtypescriptterminalinkcontractdesign
DESIGN.md Skills
DESIGN.md Skills 是 google-labs-code/design.md 仓库中收录的 AI Agent Skills 套件。design.md 是一个描述视觉身份给 AI 编程 agent 的格式规范，仓库中包含 4 个与 CLI agent 交互、终端 UI 渲染、测试驱动开发和类型安全服务契约相关的独立 skill。
来源
- 上游 skills 目录：https://github.com/google-labs-code/design.md/tree/main/.agents/skills
- 上游仓库：https://github.com/google-labs-code/design.md
- 许可证：Apache-2.0
适合什么时候用
- 需要评估或对比不同 CLI 工具对 AI agent 的友好程度（Agent DX CLI Scale）。
- 需要将 JSON 格式的 UI 规范渲染为终端交互界面（@json-render/ink）。
- 希望在 AI 辅助编程中执行严格的 TDD 三阶段循环（TDD Red-Green-Refactor）。
- 需要为 TypeScript 服务建立类型安全的 Spec/Handler 契约架构（Typed Service Contracts）。
套件内容
| Skill | 用途 |
|---|---|
agent-dx-cli-scale | 从机器可读输出、原始负载输入、Schema 自省、上下文窗口纪律、输入加固、安全护栏和 Agent 知识打包七个维度评估 CLI 的 agent 友好度（0-21 分） |
ink | 基于 Ink 将 JSON 规范转换为交互式终端组件树，支持标准组件、数据绑定、可见性控制、事件系统和流式渲染 |
tdd | 强制红-绿-重构三阶段循环的 TypeScript TDD 工作流，禁止水平扩张、施加背压、确保测试完整性 |
typed-service-contracts | Spec（Zod Schema + Result 类型）和 Handler（永不 throw 的实现）分离的类型安全服务架构标准 |
agent-dx-cli-scale
评估 CLI 对 AI agent 的设计质量。七个评分维度各 0-3 分，总分 0-21：
| 范围 | 评级 |
|---|---|
| 0-5 | Human-only — 仅为人类设计，agent 难以解析和使用 |
| 6-10 | Agent-tolerant — agent 能用但浪费 token，需要大量 prompt 工程补偿 |
| 11-15 | Agent-ready — 良好 agent 支持，结构化 I/O、输入验证和部分自省 |
| 16-21 | Agent-first — 专为 agent 设计，完整 schema 自省、输入加固和知识打包 |
ink
@json-render/ink 终端渲染器。核心概念：
- 扁平元素映射：JSON 定义
root+elements组件树 - 标准组件：Box、Text、Heading、Table、Badge、TextInput、Select、Tabs 等
- 数据绑定：
$state读取、$bindState双向绑定、$cond条件值、$template插值 - 事件系统：组件
emit+ specon映射 action - 流式渲染：
useUIStream从 API 渐进渲染 JSONL patch
tdd
Red-Green-Refactor TypeScript 版。严格迭代循环：
- Red — 写一个测试 → 执行确认因缺少逻辑而失败
- Green — 写最简单实现让测试通过
- Refactor — 在保持 Green 下改进结构
核心禁令：一次只写一个测试、绝不修改测试让实现通过。
typed-service-contracts
Spec & Handler 模式：
| 层 | 职责 |
|---|---|
| Spec | Zod 输入 Schema、输出 Schema、错误联合体、Result 类型、接口定义 |
| Handler | 实现 Spec 接口、处理副作用、永不 throw、将错误映射为 Result 类型 |
测试策略：契约测试（验证 Schema 边界）+ 逻辑测试（Mock 外部依赖，断言 Result 对象）。
安装提示
本站只收录索引和中文说明，不镜像上游 skill 文件。可通过上游仓库安装：
npx skills add https://github.com/google-labs-code/design.md/tree/main/.agents/skills
使用注意
agent-dx-cli-scale还可用于为自有 CLI 制定 agent-first 改进路线图。ink终端渲染默认 flexDirection 为 row，垂直布局需显式设置 column。tdd推荐配合 Vitest 或 Jest 使用，类型检查作为背压机制。typed-service-contracts的 Handler 必须永远不 throw，用 try-catch 兜底映射为 UNKNOWN_ERROR。