AgentSkillsCN

routine-layout-and-structure

使用标准缩进格式化函数参数，并以空行组织函数内部结构。当您定义具有多行参数的函数、编写函数实现，或制定函数格式化的编码标准时，可使用此技能。

SKILL.md
--- frontmatter
name: routine-layout-and-structure
description: Format routine parameters using standard indentation and organize routine internal structure with blank lines. Use when defining functions with multi-line parameters, writing routine implementations, or establishing coding standards for function formatting.

Routine Layout and Structure

Apply these formatting rules to improve routine readability and maintainability.

Routine Parameter Layout

When to apply: When routine parameters cannot fit on a single line

  1. •Use standard indentation for multi-line parameter lists
  2. •Place each parameter on a new line
  3. •Vertically align parameters using standard indentation

Avoid "Endline Layout":

  • •Endline layout attempts to align parameters to the right edge
  • •High maintenance cost: changing function name length requires reformatting all parameter lines
  • •Can cause right-side space limitations

Advantages of standard indentation:

  • •Better accuracy, consistency, readability, and maintainability
  • •Function name changes don't affect parameter layout
  • •Adding or removing parameters requires modifying only one line

Routine Internal Structure

When to apply: When writing routine implementations with declarations and executable code

Use blank lines to separate logical parts of the routine:

  1. •After the routine header
  2. •Around data declarations and named constant declarations (if present)
  3. •Before the routine body

Purpose: Clearly delineate the logical components (header, declarations, body) of the routine.

Result

  • •Parameter lists are clear and easy to maintain
  • •Routine structure is visually organized with clear section boundaries
  • •Code modifications don't cascade formatting changes