implement-type-annotations

此技能旨在通过系统地为 Python 和 TypeScript 代码库应用全面的类型注解，提升软件质量与开发效率。通过在 Python 中强制执行符合 PEP 484 标准的类型提示，以及在 TypeScript 中使用稳健的接口或类型定义，此代理技能可帮助开发人员在静态分析阶段捕获运行时错误，显著缩短调试时间并改善系统整体的可靠性。本工具专为软件工程师、代码库维护人员及 DevOps 团队设计，协助其现代化代码库以更好地支持 AI 辅助开发工具，这些工具高度依赖明确的类型信息来生成更精确且具备上下文感知能力的代码建议。

• 通过提供函数签名、预期参数类型及返回值的清晰可见性，提高 IDE 智能提示的准确度。

• 自动识别并修复遗留代码片段中缺失的类型注解。

• 借助提供高保真代码补全所需的结构化上下文信息，改善 AI 辅助开发（如 GitHub Copilot 或 Claude）的表现。

• 强制执行代码库内的一致性，确保类型提示在整个项目生命周期中保持统一。

• 通过启用 Mypy、Pyright 或 TypeScript 编译器等工具，在程序执行前捕获类型不匹配问题，从而促进更早期的错误检测。

• 使用时机：在软件开发项目的重构或维护阶段使用此技能以稳定代码库。

• 输入：锁定包含 Python (.py) 或 TypeScript (.ts, .tsx) 源代码的特定目录或单个文件。

• 输出：生成具备适当类型注解的已更新源代码文件，并可能附带类型覆盖率百分比的摘要报告。

• 约束：用户应具备标准的 Linting 与类型检查基础设施（如 Python 的 Mypy 或 TypeScript 的 Tsc），以便验证代理所做的变更。

• 整合：建议与 CI/CD 流水线结合使用，将类型覆盖率作为质量指标进行监控，防止类型安全随时间下降。