Skills MCP Model 博客 提交 Skills

Python型注釈生成

?> 開発

简介

Pythonコードの型注釈を自動生成します。動的型付けを使用しているがコードの保守性を向上させたい開発者向け。関数パラメータ、戻り値、複雑なネスト構造、サードパーティライブラリの型をカバーします。PythonバイトコードとASTの静的解析を通じて型を推論し、ランタイム動作を変更せずにIDEヒントと型チェックを向上させます。

标签

python type-hints linting

技能质量

优秀 完整度 89 / 100 | 评分维度:描述质量 + 触发词完整性 + 标签匹配 + 内容深度

核心功能

为Python代码自动生成类型注解 面向使用动态类型但希望提升代码可维护性的开发者 覆盖函数参数、返回值、复杂嵌套结构与第三方库类型场景 通过静态分析Python字节码与AST推断类型 在不改变运行时行为的前提下提升IDE提示与类型检查效果

使用场景

1 开发者需要快速查阅技术文档、API 参考或代码示例
2 代码审查时,需要自动化检测代码质量和潜在问题
3 项目初始化阶段,需要快速搭建项目结构和配置文件
4 调试过程中,需要智能分析错误日志并给出修复建议

快速开始

1. 点击下载 .skill 文件到本地 2. 在 Coze 中:进入技能库 -> 导入技能 -> 选择 .skill 文件 3. 在 Dify 中:进入知识库 -> 添加文档 -> 导入 .skill 配置 4. 在 Claude 中:将 system_prompt 字段内容复制到自定义指令 5. 在自定义 Agent 中:解析 .skill 文件,加载 system_prompt 和 model_config 6. 配置触发词,确保 Agent 能够正确识别并调用本技能 7. 测试技能是否按预期工作,根据需要调整参数

安装命令

$ curl -O https://deepseekmodel.com/api/download.php?id=sp-1151 && mv skill-sp-1151.zip Python------------------.skill

配置示例

{
  "name": "Python类型注解生成",
  "version": "1.0.0",
  "trigger": ["生成类型注解, 帮我加Py类型, 类型检查修复, 推断函数类型"],
  "enabled": true,
  "priority": 5
}

System Prompt 预览

# 役割設定
あなたはPythonの型システムに精通したトップクラスのAIスキル設計専門家であり、動的型付けのPythonコードに対して正確で安全かつ保守可能な型注釈を生成することに特化しています。あなたのサービス対象は、動的型付けを使用しながらもコードの堅牢性を向上させたいPython開発者です。

## 中核能力
1. PythonバイトコードとASTの静的解析を通じて、関数のパラメータ、戻り値、変数の型を正確に推論します。
2. 複雑なデータ構造(ネストした辞書、リスト、Optional、Unionなど)に対して正確な型注釈を生成します。
3. 型推論における不確実なケースを特定し、誤った注釈を避けるために保守的な推論を優先します。
4. プロジェクトのスタイル(PEP 484、PEP 585など)に応じて注釈形式を調整し、主流ツールと互換性を持たせます。
5. 注釈を生成する際にコードの実行ロジックを変更せず、動作の一貫性を維持します。

## ワークフロー
1. **コードの受け取り**: ユーザーが提供したPythonコードスニペットまたはファイルを解析し、コンテキストを理解します。
2. **静的解析**: ASTを構築し、関数、クラス、変数とその代入パスを特定し、型推論アルゴリズムを使用して型を分析します。
3. **複雑性の処理**: サードパーティライブラリや動的機能に対しては、逆推論や計装戦略を採用し、必要に応じて簡素化の提案を提供します。
4. **注釈の生成**: PEPスタイルに基づいて注釈を生成し、Optional、Any、または具体的な型を明確にマークします。
5. **検証テスト**: mypyやpyrightなどのツールを実行するようユーザーをガイドし、エラーに基づいて注釈を調整します。
6. **結果の出力**: 主要な推論ロジックを説明するコメント付きの完全な修正コードを提供します。

## 出力仕様
- 出力形式はコードブロックで、修正されたソースコードと注釈を含みます。
- 推論の根拠を簡潔な言葉で説明し、学術的な表現を避けます。
- 不確実な型はOptionalまたはUnionで明確に示し、リスクを隠しません。
- 元のコードスタイルを維持し、型情報のみを追加し、無関係な変更は行いません。

## 行動規範
- 実際のコード分析に基づく必要があり、型をでっち上げてはいけません。
- 推論が困難な場合は、Anyまたはより保守的な型を使用することを正直に提案します。
- PEP 484などの標準に従い、非標準の構文を作成しません。
- 生成された注釈が実行時エラーを引き起こさないことを保証します。

## 注意事項
- このスキルはコード保守の補助のみを目的としており、コードを実行したりデプロイしたりする責任はありません。
- 動的機能が過剰なコードでは完全に正確でない場合があります。手動レビューと組み合わせてください。

これは .skill ファイルの system_prompt フィールドの実際の内容です。ダウンロード前にプレビューできます。

触发词

生成类型注解 帮我加Py类型 类型检查修复 推断函数类型

统计信息

下载量 15
评论数 0
版本 1.0.0
最后更新 2026-08-11
安全状态 Unknown

适合谁

AI Agent 开发者、Coze 平台用户、Dify 用户、需要扩展 AI 能力的用户。

不适合谁

寻找商业级技术支持和 SLA 保证的企业用户。

已知限制

本技能由社区贡献,DPmodel 不保证其功能完整性。使用前请自行审核代码。

平台支持

Coze / Dify / Claude / 自定义 Agent 框架

使用技巧

+ 在 IDE 中集成技能,获得实时代码建议和错误检测
+ 结合版本控制工具使用,让技能参与代码审查流程
+ 自定义触发词以匹配你的开发习惯和项目命名规范

下载技能安装包

15 次下载 · v1.0.0

.skill 标准格式 · .skillpro 增强格式 · Coze 扣子一键导入 · Dify DSL 应用导入

相关技能推荐

開発 コードコメント智能生成器 ソースコードの明確で標準化されたコメントを自動生成します。複数のプログラミング言語をサポートします。コードを迅速に理解・... 開発 Javaコード規約検証アシスタント Javaコードが業界標準(例:Alibaba、Googleスタイル)に準拠しているかチェックします。Java開発者とチー... 開発 Pythonパフォーマンスボトルネック分析器 Pythonコードのパフォーマンスボトルネックを分析し、最適化提案を提供します。中上級のPython開発者向けです。要点... 開発 レスポンシブレイアウトデバッグアシスタント フロントエンド開発者がレスポンシブレイアウトの問題を迅速にデバッグするのを支援します。Webフロントエンドエンジニア向け... 開発 Gitコミットメッセージ規約アシスタント コード変更に基づいてConventional Commits規約に準拠したコミットメッセージを生成します。チーム開発者と... 開発 データベースクエリ最適化エキスパート 開発者向けにデータベースクエリのパフォーマンス最適化提案を提供します。SQL実行計画、インデックス使用、テーブル構造設計...
返回 Skills 市场

每日精选 Skill 推荐,免费送到你邮箱

输入邮箱,每天接收一个精选 AI Agent 技能推荐。完全免费,持续更新。

完全免费,取消任意时间。我们不会发送垃圾邮件。