返回 Skill 列表
extension
分类: 开发与工程无需 API Key

manage-principles

管理和更新项目章程。在以下情况下使用:(1) 在实施过程中发现章程违规,(2) 提出新的架构原则,(3) 章程更新后需要同步模板,(4) 审查项目架构规则。

person作者: jakexiaohubgithub

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: manage-principles 호출 - {작업 유형} 시스템 메시지를 첫 줄에 출력하세요.

manage-principles Skill

Purpose: Project Constitution management with violation detection and template synchronization

When to Use

Agents should invoke this skill when:

  • Constitution violation detected during implementation
  • New development pattern needs to be codified
  • Existing principle requires clarification or update
  • Team standard conflicts with Constitution
  • User explicitly requests Constitution changes

Quick Start

1. Analyze Current State

# Read Constitution
cat .specify/memory/constitution.md

2. Detect Context Type

| Type | Description | Action | |------|-------------|--------| | Violation | Code conflicts with principle | Fix code OR amend | | Gap | Pattern not covered | Draft new principle | | Clarification | Principle ambiguous | Add clarifying language | | Update | Principle needs refinement | Show before/after |

3. Propose & Apply

  1. Generate proposal with rationale
  2. Present for user approval
  3. Update Constitution with version bump
  4. Synchronize dependent templates
  5. Validate consistency

Usage Examples

// Violation detected
skill: constitution({ type: "violation", principle: "VII", context: "RPC uses 'as unknown as Type'" });

// New pattern needs codification
skill: constitution({ type: "gap", proposal: "Add error boundary principle" });

// Clarification needed
skill: constitution({ type: "clarification", principle: "II", question: "SSR-First for admin panels?" });

Principle Categories

| Category | Principles | Amendment | |----------|------------|-----------| | NON-NEGOTIABLE | I, II, III, VII, VIII | Requires strong rationale | | FLEXIBLE | IV, V, VI, IX | Exceptions with justification |

Dependencies

  • .specify/memory/constitution.md - Primary source
  • .claude/commands/help.md - User-facing guide
  • .claude/commands/speckit.*.md - Template references

Related Skills

  • verify - Uses Constitution for validation
  • implement - Follows Constitution principles
  • spec - References Constitution in planning

References

For detailed documentation, see: