跳到正文
cccskills
免费在 GitHub 公开

StreamFlow Mypy Type Checking

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.).

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

查看安装方法

包含的文件(3)

  • SKILL.md2.6 KB
  • no-untyped-def/SKILL.md2.6 KB
  • var-annotated/SKILL.md2.6 KB

SKILL.md(原文)

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

StreamFlow Mypy Type Checking Skill

Core Constraint

See AGENTS.md for the authoritative forbidden types list. If a fix requires a forbidden type, DO NOT FIX IT. Skip the error entirely.

Sub-Skills

Error codeDescriptionSub-skill
[no-untyped-def]Function missing type annotationsStreamFlow Mypy no-untyped-def Fixer skill
[var-annotated]Variable missing type annotationStreamFlow Mypy var-annotated Fixer skill

General Workflow

  1. Classify: Can the fix use concrete types only? If NO → skip entirely
  2. Fix: Add annotations (see sub-skill for patterns)
  3. Validate — must return no output:
    git diff | grep -E "Any\b|MutableMapping\[.*Any|MutableSequence\[.*Any|list\[Any|dict\[.*Any"
    
  4. Quality check — must pass:
    uv run make format-check codespell-check typing
    
  5. Commit: Load the StreamFlow Git Workflow skill

Allowed Types Quick Reference

  • Primitives: None, bool, int, str, float, bytes
  • Concrete classes: Workflow, Connector, Port, Token, etc.
  • Unions: str | None, int | bool
  • Generics: list[str], dict[str, int], set[Token]
  • Special: Self, type[MyClass], Literal["a", "b"]

Prefer Literal over str/int for fixed value sets (statuses, connector types, mode flags).

Broad arguments, narrow returns: parameters use abstract types (Iterable, Sequence, Mapping); return types use concrete types (list, dict, set).

Annotation Patterns

# Always annotate with concrete types
def process(self, workflow: Workflow, config: WorkflowConfig) -> bool: ...

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

# Optional: use X | None, not Optional[X]
def get(self, name: str) -> Connector | None: ...

# Always annotate return types — mypy strict mode requires it
async def close(self) -> None: ...

When in doubt, skip it. Better to leave an error than violate the forbidden types constraint.

See Also

  • AGENTS.md — Forbidden types list, mandatory rules
  • StreamFlow Git Workflow skill — Commit message format and approval workflow
  • StreamFlow Code Style skill — Code style guidelines

评价

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

评论

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

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

提交后会立即公开。请勿填写邮箱、电话等个人信息。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月19日 更新

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月19日 更新

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月19日 更新

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月19日 更新

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月19日 更新

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.

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

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

查看 alpha-unito 的全部技能

报告此技能的问题