AgentSkillsCN

c3

当用户提出“采纳 C3”“将我纳入架构体系”“搭建 C3 文档”“初始化 C3”“审计架构”“验证 C3”或“检查 C3 文档”时，应使用此技能。 若当前不存在 .c3/ 目录，亦会触发该技能。导航时转至 c3-query，变更时则交由 c3-alter 处理。

SKILL.md
--- frontmatter
name: c3
description: |
  This skill should be used when the user asks to "adopt C3", "onboard me to architecture",
  "scaffold C3 docs", "init C3", "audit architecture", "validate C3", or "check C3 docs".
  Also triggers when no .c3/ directory exists. Routes to c3-query for navigation, c3-alter for changes.

C3 Architecture Assistant

REQUIRED: Load Harness First

Load ../../references/skill-harness.md for routing and red flags.

Mode Selection

ConditionMode
No .c3/README.mdAdopt - Set up C3
Has .c3/ + "audit" intentAudit - Validate docs
Has .c3/ + other intentRoute to c3-query or c3-alter

Mode: Adopt

Two rounds:

Round 1: Structure

User runs: PROJECT="MyApp" C1="backend" C2="frontend" ./scripts/c3-init.sh

Creates .c3/ with Context, Containers, ADR-000.

Round 2: Fill (Subagent)

Dispatch subagent with ../../references/container-patterns.md to:

LayerTask
Context (c3-0)Actors, containers, external systems, diagram, linkages
Container (c3-N)Assess complexity first, then components, diagram, fulfillment
Component (c3-NNN)Create from category template, add ## References
ADR-000Document adoption, list containers, verification

Templates: ../../templates/component.md (unified), ../../templates/ref.md

Rules:

  • •Complexity-first: Assess container complexity BEFORE documenting aspects
  • •Discovery-over-checklist: Find what exists, don't assume from templates
  • •Diagram first, tables second, linkages third
  • •Every linkage needs REASONING
  • •Sequential IDs: c3-101, c3-102, etc.
  • •References: symbols first, patterns, then paths (3-7 items)
  • •Categories: foundation or feature (no auxiliary)

Refs Discovery

After components are documented:

  1. •Identify repeated patterns across components
  2. •Extract to .c3/refs/ref-{pattern}.md
  3. •Update components to cite refs instead of duplicating

Mode: Audit

REQUIRED: Load ../../references/audit-checks.md for full procedure.

ScopeCommand
Full systemaudit C3
Containeraudit container c3-1
ADRaudit adr adr-YYYYMMDD-slug

Checks: Inventory vs code, categorization, reference validity, diagrams, ADR lifecycle