SKILL：代码生成

目的

生成符合仓库规范、可测试且可安全运行的生产就绪代码（TypeScript/JavaScript/Python）。

适用场景

• 拥有明确的需求说明和验收标准时。
• 需要新增模块、组件或函数时。
• 请求执行小到中等范围的实现工作时。

输入参数

• spec（必填，字符串或对象）：功能需求 + 验收标准。
• language（必填，枚举值：ts|js|py）：目标编程语言。
• targets（可选，字符串数组）：需要创建或修改的文件/模块。
• constraints（可选，字符串数组）：安全、性能或兼容性要求。
• test_expectations（可选，字符串）：需添加或运行的测试内容。

执行步骤

1. 验证需求说明：

- 确认输入与输出定义

- 确认错误处理逻辑

- 识别缺失的需求（如关键信息缺失，应主动询问）

1. 检查目标区域现有代码风格与设计模式。
2. 生成最小化、模块化的代码：

- 使用小型函数

- 在 TypeScript 中显式声明类型（如有必要）

- 明确错误处理路径

1. 添加或更新测试，确保覆盖验收标准中的关键行为。
2. 仅在变更确实需要时，才更新文档或配置文件。
3. 提供确定性的验证命令序列（如 lint/test/build）。

验证标准

• 代码语法正确，符合项目编码规范。
• 测试覆盖核心行为，且在修复前能触发失败（如适用）。
• 不引入任何密钥、凭证或敏感信息。
• 若使用外部 API，必须显式声明并支持通过环境变量或配置进行设置，包含超时与重试机制。

输出结果

• files_changed：受影响的文件路径列表
• summary：本次变更的简要说明
• validation_commands：按顺序执行的验证命令列表
• notes：任何假设条件或后续待办事项

安全规则

• 禁止嵌入密钥、私钥或令牌等敏感信息。
• 除非明确要求且已隔离沙箱环境，否则禁止引入动态代码执行（如 eval、运行时编译）。
• 测试中避免发起网络请求，除非已明确控制或使用模拟（mock）。
• 优先采用增量式修改，避免高风险重构。

示例

输入：

• language: ts
• spec: “实现 parseUserId(input) 函数，对非 UUID 格式的输入抛出错误。”

输出（片段）：

• files_changed: ["src/utils/ids.ts", "src/utils/ids.test.ts"]
• validation_commands: ["pnpm test", "pnpm lint"]