跳到正文
cccskills
免费在 GitHub 公开

StreamFlow Mypy no-untyped-def Fixer

This skill should be used when the user encounters "no-untyped-def" mypy errors, asks to "fix no-untyped-def errors", "add type annotations to functions", or mentions "Function is missing a type annotation". Provides specific workflow for fixing missing type annotations while respecting forbidden type constraints.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

StreamFlow Mypy Sub-Skill: no-untyped-def

Error: [no-untyped-def] — function or method missing type annotations.

Decision Process

For each function: can all parameters and the return type use concrete types?

  • YES → fix it
  • NO (any type needs Any, dict[str, Any], etc.) → skip the entire function

Workflow

  1. Identify errors:
    uv run mypy path/to/file.py | grep "no-untyped-def"
    
  2. Classify each function as FIXABLE or UNFIXABLE (see above)
  3. Add annotations to FIXABLE functions only
  4. Validate & commit: Load the StreamFlow Mypy Type Checking skill — General Workflow steps 3–5

Key Patterns

# Simple return types
async def close(self) -> None: ...
def is_ready(self) -> bool: ...

# Literal for fixed value sets (preferred over bare str/int)
def get_status(self) -> Literal["pending", "running", "completed", "failed"]: ...
def set_mode(self, mode: Literal["sync", "async"]) -> None: ...

# Broad arguments, narrow returns
from collections.abc import Iterable, Sequence, Mapping

def process(self, items: Iterable[Token]) -> list[str]: ...    # broad arg, narrow return
def validate(self, cfg: Mapping[str, str]) -> bool: ...        # read-only dict arg

# Optional
def get_connector(self, name: str) -> Connector | None: ...

# Self for classmethods
@classmethod
async def load(cls, persistent_id: int) -> Self: ...

# TypedDict for structured dicts (avoids dict[str, Any])
class ConnectorConfig(TypedDict):
    name: str
    enabled: bool

def get_config(self) -> ConnectorConfig: ...

SKIP these — require forbidden types:

def get_config(self): return {"key": self.value}      # needs dict[str, Any]
def get_items(self): return [self.id, self.cfg]        # needs list[Any]
def save(self): return self.config                     # MutableMapping[str, Any]

Common abstract argument types: Iterable[T] (iteration only) · Sequence[T] (indexing) · Mapping[K, V] (read-only dict)

If any return path needs a forbidden type, skip the whole function.

See Also

  • StreamFlow Mypy Type Checking skill — General workflow, allowed types reference
  • AGENTS.md — Forbidden types list, commit approval rule

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

This skill should be used when the user asks to "update the changelog", "add a changelog entry", "write a CHANGELOG entry", or when preparing a git commit in StreamFlow that requires updating the `## [Unreleased]` section of `CHANGELOG.md`.

中文简介正在准备中。当前显示原文说明。

alpha-unito/streamflow672026年10月23日 更新

This skill should be used when the user asks to "add docstrings", "write error handling", "use naming conventions", "handle exceptions", or when writing new Python code for StreamFlow that requires docstring format, naming conventions, exception handling, or async cleanup patterns.

中文简介正在准备中。当前显示原文说明。

alpha-unito/streamflow672026年10月23日 更新

This skill should be used when the user asks to "write documentation", "add a doc page", "update RST files", "add a tutorial", or when writing or editing Sphinx RST documentation for StreamFlow.

中文简介正在准备中。当前显示原文说明。

alpha-unito/streamflow672026年10月23日 更新

This skill should be used when the user asks to "add an example", "write a tutorial", "document a new workflow example", or when creating a new worked example under `docs/source/examples/`.

中文简介正在准备中。当前显示原文说明。

alpha-unito/streamflow672026年10月23日 更新

This skill should be used when the user asks to "write a commit message", "create a commit", "format a commit", "what commit type to use", or when preparing changes for a git commit in StreamFlow. Provides commit message format, type conventions, and examples.

中文简介正在准备中。当前显示原文说明。

alpha-unito/streamflow672026年10月23日 更新

This skill should be used when the user asks to "fix mypy errors", "add type annotations", "fix type checking", "resolve no-untyped-def", "fix mypy type errors", or when working with type hints while respecting StreamFlow's forbidden type constraints (no Any, dict[str, Any], etc.).

中文简介正在准备中。当前显示原文说明。

alpha-unito/streamflow672026年10月23日 更新

查看 alpha-unito 的全部技能

报告此技能的问题