AgentSkillsCN

architecture

设计并维护软件包架构、模块边界及公共接口。

SKILL.md
--- frontmatter
name: architecture
description: Design and maintain package architecture, module boundaries, and public interfaces.

Architecture

Rules

  1. Keep runtime code in src/{{ cookiecutter.package_name }}/.
  2. Keep CLI parsing in cli.py and business logic in dedicated modules.
  3. Keep public interfaces typed and explicit.
  4. Keep pyproject.toml metadata consistent with package runtime version.
  5. Treat these modules as shared package foundations and keep them coherent: settings.py, logging.py, async_runner.py, exceptions.py.
  6. Ensure package-specific exceptions always inherit from PackageError.

Validation

  • uv run pytest -m unit
  • uv run {{ cookiecutter.project_slug }} --help