AgentSkillsCN

architecting

从全生命周期视角出发,规划并架构新功能。无论是功能设计、方案规划、功能实现,还是功能扩展,皆可调用此技能。触发条件包括“新功能开发”“设计阶段”“方案规划”“功能落地”“架构设计”“产品需求分析”“功能规格说明”等环节。

SKILL.md
--- frontmatter
name: architecting
description: Architects new features through the full lifecycle. Use when designing, planning, implementing, or extending features. Triggers on 'new feature', 'design', 'plan', 'implement', 'architect', 'prd', 'spec'.

Architect Feature

Role: Oversee the entire lifecycle of a Feature—from 0 to 1 to N—ensuring architectural consistency and UX integrity.

When to use this skill

  • Creating a new feature from scratch
  • Extending an existing feature with new capabilities
  • Implementing code based on a finalized design spec

How to use it

Choose a mode based on your intent:

ModeTrigger keywordsScenario
DESIGNnew feature, 设计Create a brand-new feature directory from scratch
EXTEND扩展, add capabilityAdd sub-capabilities to an existing feature
BUILDimplement, 实现Code an already-designed spec

DESIGN Mode (从 0 到 1)

  1. Context Check: Read src/features/ to avoid reinventing the wheel.
  2. KISS Check: Really need a new directory? If < 3 files, consider shared.
  3. Generate Spec: Use resources/spec-template.md.
  4. Tech Decisions: Define dependencies and Schema.

Output: src/features/{name}/docs/spec.md


EXTEND Mode (从 1 到 N)

  1. Locate Host: Identify the target Feature.
  2. Architecture Conformance: Read the host's spec.md, follow its design philosophy.
  3. Incremental Design: Append an "Extension Section" instead of creating new docs.

Output: Updated src/features/{name}/docs/spec.md or core code.


BUILD Mode (编码实现)

  1. Read Contract: Always read spec.md first for scope.
  2. Quality Gate: Establish "Type-First" (Zod Schema -> TypeScript Type).
  3. Layered Implementation:
    • L1 Core: Schema & Service (no UI, pure logic)
    • L2 UI: Components (no business logic)
    • L3 Integration: Pages & Routing
  4. Self-Verify: npm run type-check and npm run lint must pass.

Resources

ResourcePurpose
spec-template.mdStandardized design doc template
kiss-checklist.mdAnti-over-engineering checklist
anti-patterns.mdArchitecture anti-pattern warnings

Quality Baseline

As an architect, you MUST reject:

  • Circular Dependencies: Features importing each other.
  • Global State Abuse: Local state pushed to global store.
  • Any Type: Even one any is a disgrace.
  • Implicit Logic: Critical logic without comments or docs.