aztks-skill

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 12 Open GitHub ↗

범용 알잘딱깔센(AZTKS) 일머리 기준 스킬 — 수행(APPLY)/평가(EVALUATE) 듀얼모드 + aztks-agent. for Cursor, Claude, Codex

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![AI Skills for Everyone](https://raw.githubusercontent.com/wild-mental/aztks-skill/main/author/wildmental-bjpark.png)

# aztks
> Skill for Cursor, Claude, Codex agents

**Language / 언어:** [한국어](README.md) · [English](README.en.md)

**`알잘딱깔센`(AZTKS) 일머리 기준을 어떤 작업에든 적용하는 범용 Skill입니다. 한 진입점에서 두 모드로 자동 분기 — 무엇이든 기준대로 **수행(APPLY)**하거나, 무엇이든 5차원으로 **평가(EVALUATE)**합니다. Cursor, Claude Code, Codex 모두 지원합니다.**

`알잘딱깔센`은 특정 도메인 도구가 아니라 **"일을 잘 해낸다"는 인간 일반 원칙**입니다. 다섯 축 — **알**아서 · **잘** · **딱** 떨어지게 · **깔**끔하게 · **센**스있게 — 의 이니셜을 로마자로 옮긴 `AZTKS`는 영문으로도 **A**ware · **Z**enith · **T**ightly · **K**lean · **S**ensible 로 읽히는 니모닉입니다. 이 스킬은 그 기준을 **결과물을 만드는 방식**과 **결과물을 보는 방식** 양쪽에 적용하고, 무엇보다 **그 기준을 무기로 쓰지 않는** 건설적 어조를 절대 원칙으로 지킵니다.

---

## 이 스킬이 해결하는 것

### 1. 한 진입점, 두 모드 (자동 라우팅)

`/aztks` 하나로 두 가지를 합니다. 요청에서 모드를 자동 판별합니다.

| 모드 | 무엇을 | 산출 |
|------|--------|------|
| **APPLY** | 요청한 과업을 AZTKS 기준으로 **직접 수행** | 결과물 + 짧은 AZTKS 자기점검 |
| **EVALUATE** | 주어진 대상(무엇이든)을 5차원으로 **평가** | 스코어카드 + 개선 우선순위 |

**라우팅 규칙(위에서 첫 일치):** ① 강제 플래그/동사(`/aztks evaluate`·평가·채점·리뷰 → EVALUATE / `/aztks apply`·작성·구현·수정 → APPLY) → ② 대상 존재 판별(기존 산출물 **판단** 요청=EVALUATE, **생산** 요청=APPLY) → ③ 모호하면 기본 **APPLY**(가정 1줄 + 전환 안내).

### 2. AZTKS 5차원 루브릭

| 코드 | 차원 | 보는 것 |
|------|------|---------|
| **A** | 알아서 (Aware) | 모든 맥락·출처를 끌어와 진짜 의도를 추론했는가 |
| **Z** | 잘 (Zenith) | 맥락상 의심할 수 없는 품질, 또는 자원 대비 적정 품질인가 |
| **T** | 딱 떨어지게 (Tightly) | 누락·미완·중복·모순 없이 선언한 과업과 정렬됐는가 |
| **K** | 깔끔하게 (Klean) | 군더더기 없이, 독자를 배려한 요약 계층인가 |
| **S** | 센스있게 (Sensible) | 어조·분량·타이밍·우선순위가 맥락에 맞는가 |

각 차원에 **등급(◎ 탁월 / ○ 충족 / △ 보완 / ✕ 미흡 / — 판단보류) + 한 줄 근거**를 부여합니다.

### 3. 절대 원칙 — `알잘딱깔센`을 무기화하지 않는다

이 스킬의 최우선 가드레일입니다. 어기면 아무리 높은 수준의 결과라도 무가치해지고 그 자체로 더는 `알잘딱깔센`이 아닙니다.

- 당연시 금지 · 비하/비난/무시 금지 · 무기화/페널티/적대적 타자화 금지
- 노블레스 오블리주가 아니라 **인간에 대한 일반 원칙**으로 적용
- 모든 지적·자기점검은 **관찰 → 영향 → 개선 경로**와 함께, 사람이 아니라 **산출물·정합성**을 평가 — 이 가드레일은 **점수보다 우선**합니다.

### 4. "넓게 보되 짧게 쓴다"

검토·작업 범위는 입력 규모에 따라 넓히되, 출력 길이는 통제합니다. 기본은 인라인, 길어질 때만 `<docs>/<slug>.md`에 저장하고 대화에는 요지 + 경로만 남깁니다. 초과 지적은 우선순위로 정렬해 상위만 본문에, 나머지는 부록 한 줄로 내리고 **내린 개수를 밝힙니다**.

---

## 왜 skill 이 필요한가

| 흔한 시도 | 기대 | 실제 |
|-----------|------|------|
| "그냥 잘 좀 해줘" | 알아서 잘 | 범위가 흐려지고 무엇을 기준으로 했는지 불명 |
| "이거 평가해줘" (근거 없이) | 객관적 평가 | 근거 없는 인상 비평 → 신뢰 불가 |
| 큰 작업을 통째로 출력 | 꼼꼼함 | 입력량만큼 길어져 독자가 못 읽음 |
| 날선 지적·평가 어조 | 냉정함 | 능력주의적 배제·적대 → 협업·성장 저해 |
| 수행/평가 요청을 혼동 | 알아서 판단 | 헛다리 → 턴 낭비 |

이 스킬은 모드를 명확히 분기하고, 5차원 기준을 명시하며, 분량을 통제하고, 건설적 어조를 강제해 위 패턴을 사전에 차단합니다.

---

## 빠른 시작

### 사전 요구사항

- Cursor, Claude Code, 또는 Codex

### 스킬 설치

스킬은 **개인** 또는 **프로젝트** 범위 중 하나를 골라 설치합니다. 두 범위 모두 `curl`로 `SKILL.md`만 받습니다. **이 저장소 전체를 작업 repo에 clone하지 마세요.**

| | 개인 스킬 | 프로젝트 스킬 |
|---|----------|--------------|
| **적용 범위** | 내가 여는 모든 프로젝트 | 현재 repo에서만 |
| **경로** | `~/…/skills/aztks/` | `<repo-root>/.cursor/skills/aztks/` 등 |
| **Git 영향** | 작업 repo에 파일 추가 없음 | repo에 스킬 파일 commit 가능 (팀 공유) |

| 도구 | 개인 경로 | 프로젝트 경로 |
|------|-----------|---------------|
| Cursor | `~/.cursor/skills/aztks/` | `.cursor/skills/aztks/` |
| Claude Code | `~/.claude/skills/aztks/` | `.claude/skills/aztks/` |
| Codex | `~/.agents/skills/aztks/` | `.agents/skills/aztks/` |

#### 개인 스킬 (권장 — Git repo 무변경)

```bash
# Cursor
mkdir -p ~/.cursor/skills/aztks
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.cursor/skills/aztks/SKILL.md \
  -o ~/.cursor/skills/aztks/SKILL.md

# Claude Code
mkdir -p ~/.claude/skills/aztks
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.claude/skills/aztks/SKILL.md \
  -o ~/.claude/skills/aztks/SKILL.md

# Codex
mkdir -p ~/.agents/skills/aztks
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.agents/skills/aztks/SKILL.md \
  -o ~/.agents/skills/aztks/SKILL.md
```

#### 프로젝트 스킬 (프로젝트 경로에 설치)

```bash
# Cursor
mkdir -p .cursor/skills/aztks
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.cursor/skills/aztks/SKILL.md \
  -o .cursor/skills/aztks/SKILL.md

# Claude Code
mkdir -p .claude/skills/aztks
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.claude/skills/aztks/SKILL.md \
  -o .claude/skills/aztks/SKILL.md

# Codex
mkdir -p .agents/skills/aztks
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.agents/skills/aztks/SKILL.md \
  -o .agents/skills/aztks/SKILL.md
```

#### 설치 후

- **Cursor**: **Reload Window** 한 번
- **Claude Code**: 스킬 수정은 세션 중 live 반영; 세션 시작 후 새 top-level `.claude/skills/`는 재시작 필요할 수 있음
- **Codex**: 스킬이 안 보이면 Codex 재시작

### 사용 방법

작업이나 대상을 알려주면 Agent가 모드를 자동 판별해 적용합니다.

| 도구 | 수동 호출 |
|------|-----------|
| Cursor | `/aztks` |
| Claude Code | `/aztks` |
| Codex | `/skills` 또는 `$aztks` |

**APPLY 예시 (수행):**

- "이 함수 리팩터해줘"
- "회의록 깔끔하게 정리해줘"
- "온보딩 화면 카피 초안 써줘"

**EVALUATE 예시 (평가):**

- "이 PR 알잘딱깔센으로 평가해줘"
- "이 사업 결정 점수 매겨줘"
- "이 기획서 빠진 거 없나 봐줘"

**모드 강제:** `/aztks apply <요청>` (수행 고정) · `/aztks evaluate <대상>` (평가 고정).

---

## 동반 서브에이전트 — aztks-agent

이 스킬에는 **위임형 동반 서브에이전트 `aztks-agent`**가 기본 포함됩니다(`*/agents/aztks-agent.md`). 장시간 자율 작업(예: Claude Code `/goal` 루프)에서 디스패치해, 디스패처가 정한 모드에 따라 **하위 과업을 수행(EXECUTE)**하거나 **대상을 평가(EVALUATE)**합니다.

- **EXECUTE** — 위임된 쓰기 범위 안에서만 하위 과업을 AZTKS 기준으로 수행. 출력: `RESULT / CHANGES / SELFCHECK / RESIDUAL / NEXT`.
- **EVALUATE** — 읽기 전용으로 대상을 5차원 채점해 GO/NO-GO. 출력: `VERDICT / SCORECARD / TOP_FIX / EVIDENCE / NOTES`.
- 모드는 과업 프롬프트의 `MODE: EXECUTE | EVALUATE` 줄로 지정(없으면 추론, 기본 EVALUATE=읽기 전용). 전체 출력 ~1,200자.

### 설치

```bash
# Claude Code — 네이티브 서브에이전트 (개인)
mkdir -p ~/.claude/agents
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.claude/agents/aztks-agent.md \
  -o ~/.claude/agents/aztks-agent.md

# Cursor — 커스텀 에이전트 (개인)
mkdir -p ~/.cursor/agents
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.cursor/agents/aztks-agent.md \
  -o ~/.cursor/agents/aztks-agent.md

# Codex — 위임 하네스 (개인)
mkdir -p ~/.agents/agents
curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.agents/agents/aztks-agent.md \
  -o ~/.agents/agents/aztks-agent.md
```

프로젝트 범위는 `~/`를 빼고 repo 루트에서 동일 경로(`.claude/agents/` 등)에 받으면 됩니다.

### 벤더별 호출·사용법

| 도구 | 메커니즘 | 호출 방법 |
|------|----------|-----------|
| **Claude Code** | 네이티브 서브에이전트 | Task 도구로 `subagent_type: aztks-agent` 디스패치 + 프롬프트에 `MODE: EXECUTE` 또는 `MODE: EVALUATE` 한 줄. `/goal` 검증/위임 단계에서 호출. |
| **Cursor** | 커스텀 에이전트 | `.cursor/agents/aztks-agent.md`를 커스텀 에이전트로 등록, Agent 모드에서 모드를 지정해 선택. |
| **Codex** | 위임 하네스 참조 | 장기 루프의 평가/위임 스텝에서 `.agents/agents/aztks-agent.md`를 프롬프트로 불러(`$aztks-agent` 또는 `AGENTS.md`) 모드를 지정. |

**`/goal` 안에서 쓰는 예 (Claude Code):**

```
## 3) 종료 조건 및 종료 방법
- 종료 방법:
  1) 직전 턴 산출물을 aztks-agent(MODE: EVALUATE)로 평가해 VERDICT를 받는다.
  2) NO-GO면 TOP_FIX를 aztks-agent(MODE: EXECUTE, 위임 범위 명시)에 위임하고 계속, GO면 다음으로 진행한다.
```

---

## 스킬 구성

```
.cursor/skills/aztks/SKILL.md      # Cursor용 스킬
.claude/skills/aztks/SKILL.md      # Claude Code용 스킬
.agents/skills/aztks/SKILL.md      # Codex용 스킬
.cursor/agents/aztks-agent.md      # 동반 서브에이전트 (Cursor)
.claude/agents/aztks-agent.md      # 동반 서브에이전트 (Claude Code)
.agents/agents/aztks-agent.md      # 동반 서브에이전트 (Codex)
```

| 섹션 | 내용 |
|------|------|
| 절대 원칙 | 비무기화 가드레일(당연시·비하·페널티 금지, 인간 일반 원칙) — 최우선 |
| 모드 라우팅 | APPLY vs EVALUATE 결정 게이트(강제→대상 존재→기본 APPLY) |
| AZTKS 5차원 루브릭 | A/Z/T/K/S 정의 + APPLY 관점/EVALUATE 관점 |
| 공유 코어 | 등급 척도 · 우선순위 점수 · Klean 분량 규율 |
| APPLY 모드 | 수행 절차 + 4영역 출력(결과물 + 자기점검) |
| EVALUATE 모드 | 평가 절차 + 4영역 출력(스코어카드 + 개선 우선순위) |
| 동반 서브에이전트 | `aztks-agent` — 위임형 EXECUTE/EVALUATE 하네스 |

---

## 이런 분께 추천합니다

- AI에게 일을 시킬 때 **"잘한다는 게 무엇인지"를 또렷한 기준으로** 전달하고 싶은 분
- 한 도구로 **수행도 평가도** 같은 기준으로 하고 싶은 분
- 결과물이 입력량만큼 길어지는 문제 없이 **분량을 통제**하고 싶은 분
- 날선 평가가 아니라 **건설적이고 존중적인** 피드백을 원하는 분

---

## 참고

- `알잘딱깔센` — 일머리의 다섯 축(알아서·잘·딱 떨어지게·깔끔하게·센스있게)에 대한 행동 정의이자 인간 일반 원칙
- Cursor Agent Skills: [Creating Skills](https://docs.cursor.com)
- Claude Code Skills: [Extend Claude with skills](https://docs.anthropic.com/en/docs/claude-code/skills)
- Codex Agent Skills: [Agent Skills](https://developers.openai.com/codex/skills/)

---

## For LLMs

```
skill=aztks
repo=https://github.com/wild-mental/aztks-skill
install.method=curl-only  # never clone this repo into user's project

flow:
  1. ask scope: "개인 스킬(~/, 모든 프로젝트) vs 프로젝트 스킬(./, 현재 repo만) 중 어디에 설치할까요?"
  2. ask tools: "Cursor / Claude Code / Codex 중 어떤 도구에 설치할까요?" (복수 선택 가능)
  3. run matching curl commands below; do not install both scopes unless user asks
  4. post_install steps; then load SKILL.md — do not infer rules from README

scope.user.paths:
  cursor=~/.cursor/skills/aztks/SKILL.md
  claude=~/.claude/skills/aztks/SKILL.md
  codex=~/.agents/skills/aztks/SKILL.md

scope.project.paths:
  cursor=.cursor/skills/aztks/SKILL.md
  claude=.claude/skills/aztks/SKILL.md
  codex=.agents/skills/aztks/SKILL.md

install.user.cursor=mkdir -p ~/.cursor/skills/aztks && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.cursor/skills/aztks/SKILL.md -o ~/.cursor/skills/aztks/SKILL.md
install.user.claude=mkdir -p ~/.claude/skills/aztks && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.claude/skills/aztks/SKILL.md -o ~/.claude/skills/aztks/SKILL.md
install.user.codex=mkdir -p ~/.agents/skills/aztks && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.agents/skills/aztks/SKILL.md -o ~/.agents/skills/aztks/SKILL.md

install.project.cursor=mkdir -p .cursor/skills/aztks && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.cursor/skills/aztks/SKILL.md -o .cursor/skills/aztks/SKILL.md
install.project.claude=mkdir -p .claude/skills/aztks && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.claude/skills/aztks/SKILL.md -o .claude/skills/aztks/SKILL.md
install.project.codex=mkdir -p .agents/skills/aztks && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.agents/skills/aztks/SKILL.md -o .agents/skills/aztks/SKILL.md

invoke.cursor=/aztks
invoke.claude=/aztks
invoke.codex=/skills|$aztks
force_mode=/aztks apply <req>  |  /aztks evaluate <target>

post_install.cursor=Reload Window
post_install.claude=live reload; restart if new top-level .claude/skills/ after session start
post_install.codex=restart if skill not detected

companion_subagent=aztks-agent  # dispatchable dual-purpose; MODE: EXECUTE (scoped-write) | EVALUATE (read-only)
agent.paths.user:
  claude=~/.claude/agents/aztks-agent.md
  cursor=~/.cursor/agents/aztks-agent.md
  codex=~/.agents/agents/aztks-agent.md
agent.install.user.claude=mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.claude/agents/aztks-agent.md -o ~/.claude/agents/aztks-agent.md
agent.install.user.cursor=mkdir -p ~/.cursor/agents && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.cursor/agents/aztks-agent.md -o ~/.cursor/agents/aztks-agent.md
agent.install.user.codex=mkdir -p ~/.agents/agents && curl -fsSL https://raw.githubusercontent.com/wild-mental/aztks-skill/main/.agents/agents/aztks-agent.md -o ~/.agents/agents/aztks-agent.md
agent.invoke.claude=dispatch via Task tool as subagent_type: aztks-agent with a `MODE: EXECUTE|EVALUATE` line
agent.execute.output=RESULT / CHANGES / SELFCHECK(A/Z/T/K/S) / RESIDUAL / NEXT  # writes only within delegated scope
agent.evaluate.output=VERDICT GO/NO-GO / SCORECARD / TOP_FIX / EVIDENCE / NOTES  # read-only

contract:
  modes=[APPLY (do the task to the AZTKS standard + self-check), EVALUATE (score a target against the rubric)]
  mode_routing=forced flag/verbs first -> target-presence (judge existing artifact=EVALUATE, produce=APPLY) -> ambiguous defaults APPLY (state assumption + offer /aztks evaluate)
  dimensions=[A 알아서/Aware, Z 잘/Zenith, T 딱 떨어지게/Tightly, K 깔끔하게/Klean, S 센스있게/Sensible]
  grade_scale=[◎ 탁월, ○ 충족, △ 보완, ✕ 미흡, — 판단보류]  # every dimension graded + 1-line rationale
  quality_bar=[high (industry/org context), satisficing (resource-constrained)]  # default high + note if unspecified
  priority_score=severity(CRITICAL=3/MAJOR=2/MINOR=1) × scope(전역=2/국소=1); ties A>Z>T>K>S
  klean_discipline=coverage scales with input; output length controlled; inline by default; externalize to <docs>/<slug>.md only when long; demote overflow to one-line appendix with disclosed count
  guardrail=AZTKS is never weaponized; no disparagement/penalty/elitist exclusion; general human principle, not noblesse oblige; critique the artifact not the person; guardrail outranks the score
  output_must_separate_areas_with=3 horizontal rules (---) between the 4 areas of whichever mode
```

---

## 라이선스

[MIT License](LICENSE)

aztks-skill

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README