一键在 Manus 中运行任何 Skill

writing-nova-skill

星标2

分支1

更新时间2026年5月27日 05:01

새 Nova 스킬을 작성하거나 기존 스킬 description을 수정할 때. — MUST TRIGGER: skills/ 하위 신규 SKILL.md 생성, 기존 SKILL description 리팩터, 사용자가 'Nova 스킬 추가/수정' 요청 시.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

TeamSPWK

TeamSPWK/nova

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Writing a Nova Skill

Nova 스킬을 작성/수정할 때 따라야 할 규약. Jesse Vincent(obra/superpowers)의 실측 발견 — "description이 workflow를 요약하면 Claude가 본문 대신 description을 따라간다" — 을 Nova에 흡수한 메타-스킬.

핵심 규약

1. Description = When-to-use only

description은 언제 발동하는가만 기술한다. HOW(동작 방식)은 본문으로.

금지:

→, 파이프라인, 4단, Explorer×3 같은 단계 열거
"X로 Y를 Z한다" 형식의 동작 기술 전체
"엔진", "시스템"만 선언하는 정체성 홍보 (예: "Nova XXX 엔진 —")

요구:

"...할 때.", "...가 필요한 경우" 같은 트리거 표현
MUST TRIGGER: ... 섹션에 트리거 조건 3개 이상
사용자 요청 패턴 포함 (예: "사용자가 /nova:xxx 호출 시")

예시 (evaluator):

❌ "Nova Adversarial Evaluator — Nova Quality Gate의 핵심 검증 엔진. 독립 서브에이전트로 코드를 적대적 관점에서 검증."
✅ "코드 구현을 적대적 관점으로 검증해야 할 때. — MUST TRIGGER: /run, /check, /review 내부에서 독립 서브에이전트로 호출, 스프린트 완료 직후, 커밋 전 Evaluator PASS 필요 시."

2. 본문 구조

한 문단 — 스킬 목적 + Nova 5기둥 내 위치
## 핵심 원칙 — 설계 결정 3~5개
## 적용 규칙 (on-demand 로드) — 참조하는 nova-rules §N 번호
## 오케스트레이션 추적 — mcp__plugin_nova_nova__orchestration_update 호출 의무 (해당 시)
예시 / 안티패턴

3. 트리거 회귀 테스트 (MUST)

새 스킬 추가 시 tests/skill-triggering/prompts/{name}-positive.txt 제출 의무.

positive: 이 스킬이 반드시 발동해야 할 사용자 프롬프트 1개
negative (선택): 이 스킬이 발동하면 안 되는 유사 맥락 프롬프트

tests/test-skill-triggering.sh가 각 skills/*/SKILL.md에 대응하는 positive fixture 존재를 강제한다. 누락 시 CI FAIL.

실제 LLM 트리거 검증은 Nova 개발자 전용 dev/skills/field-test/로 수동 수행 (사용자 플러그인에는 미포함).

4. 동기화 체크리스트 (CLAUDE.md와 일치)

새 스킬 추가 시:

hooks/session-start.sh 커맨드 목록 영향 여부 확인 (커맨드 아니면 대개 불필요)
tests/test-scripts.sh의 description lint 통과 확인
docs/nova-meta.json — bump-version.sh가 자동 재생성 (수동 편집 금지)
tests/skill-triggering/prompts/{name}-positive.txt 제출

안티패턴

description을 짧게 만들려고 트리거를 생략한다 → Claude가 언제 쓸지 판단 못 함
"5인 적대 평가자", "3단 파이프라인" 같은 숫자 홍보 → 본문 스킵 유발
여러 목적을 한 스킬에 몰아넣는다 → 트리거 모호, 본문 비대

근거 (왜 이 규약이 존재하는가)

obra/superpowers/skills/writing-skills/SKILL.md — "Testing revealed that when a description summarizes the skill's workflow, Claude may follow the description instead of reading the full skill content"
memory/project_nova_competitive_analysis_2026_04_23.md — 경쟁 분석 결과 9개 Nova SKILL 중 5개가 이 안티패턴에 해당, Tier 1.1에서 일괄 리팩터
Nova 5기둥 중 협업 기둥 — 스킬이 제 때 발동하지 않으면 에이전트 협업이 붕괴한다

同仓库更多 Skills

同仓库

context-chain

TeamSPWK/nova

세션 간 맥락을 연결해야 할 때. — MUST TRIGGER: 세션 시작 시 NOVA-STATE.md 읽기, 커밋 후 상태 갱신, 스프린트 전환 시.

2026-06-022

evolution

TeamSPWK/nova

Nova 자체를 진화시킬 때 사용한다. — MUST TRIGGER: /nova:evolve 호출, 외부 기술 동향을 Nova에 반영해야 할 때, Nova 메타-개선(규칙/스킬/훅 구조 변경) 작업.

2026-06-012

jury

TeamSPWK/nova

단일 Evaluator의 편향이 우려되는 중요 판단일 때 여러 관점으로 재검토한다. — MUST TRIGGER: 아키텍처 결정, 릴리스 게이트 의심 케이스, 사용자가 /nova:ask 또는 다관점 평가를 요청할 때.

2026-05-272

field-test

TeamSPWK/nova

Nova 방법론을 실제 프로젝트에서 검증해 개선 포인트를 찾을 때. — MUST TRIGGER: 신규 Nova 기능 검증, 사용자가 실전 피드백을 요청할 때, 워크트리 격리 환경에서 방법론을 리허설할 때.

2026-05-272

orchestrator

TeamSPWK/nova

자연어 요청을 받아 전체 개발 사이클을 자동 처리해야 할 때. — MUST TRIGGER: /nova:auto 호출, 사용자가 '전체 알아서 해줘' 유형의 요청을 할 때, 다중 에이전트 편성이 필요한 복합 작업.

2026-05-232

deepplan

TeamSPWK/nova

Plan 문서의 탐색 폭/검증 깊이가 부족할 때 깊이 있는 Plan을 생성한다. — MUST TRIGGER: 복잡도 8+ 작업, 아키텍처 분기 결정, /nova:plan 결과가 얕다고 판단되는 경우, 사용자가 /nova:deepplan 호출.

2026-05-192

name	writing-nova-skill
description	새 Nova 스킬을 작성하거나 기존 스킬 description을 수정할 때. — MUST TRIGGER: skills/ 하위 신규 SKILL.md 생성, 기존 SKILL description 리팩터, 사용자가 'Nova 스킬 추가/수정' 요청 시.
description_en	Use when authoring a new Nova skill or revising an existing skill's description. — MUST TRIGGER: creating a new SKILL.md under skills/, refactoring an existing SKILL description, or when the user asks to 'add or modify a Nova skill'.
user-invocable	false

Writing a Nova Skill

핵심 규약

1. Description = When-to-use only

description은 언제 발동하는가만 기술한다. HOW(동작 방식)은 본문으로.

금지:

→, 파이프라인, 4단, Explorer×3 같은 단계 열거
"X로 Y를 Z한다" 형식의 동작 기술 전체
"엔진", "시스템"만 선언하는 정체성 홍보 (예: "Nova XXX 엔진 —")

요구:

"...할 때.", "...가 필요한 경우" 같은 트리거 표현
MUST TRIGGER: ... 섹션에 트리거 조건 3개 이상
사용자 요청 패턴 포함 (예: "사용자가 /nova:xxx 호출 시")

예시 (evaluator):

❌ "Nova Adversarial Evaluator — Nova Quality Gate의 핵심 검증 엔진. 독립 서브에이전트로 코드를 적대적 관점에서 검증."
✅ "코드 구현을 적대적 관점으로 검증해야 할 때. — MUST TRIGGER: /run, /check, /review 내부에서 독립 서브에이전트로 호출, 스프린트 완료 직후, 커밋 전 Evaluator PASS 필요 시."

2. 본문 구조

한 문단 — 스킬 목적 + Nova 5기둥 내 위치
## 핵심 원칙 — 설계 결정 3~5개
## 적용 규칙 (on-demand 로드) — 참조하는 nova-rules §N 번호
## 오케스트레이션 추적 — mcp__plugin_nova_nova__orchestration_update 호출 의무 (해당 시)
예시 / 안티패턴

3. 트리거 회귀 테스트 (MUST)

새 스킬 추가 시 tests/skill-triggering/prompts/{name}-positive.txt 제출 의무.

positive: 이 스킬이 반드시 발동해야 할 사용자 프롬프트 1개
negative (선택): 이 스킬이 발동하면 안 되는 유사 맥락 프롬프트

tests/test-skill-triggering.sh가 각 skills/*/SKILL.md에 대응하는 positive fixture 존재를 강제한다. 누락 시 CI FAIL.

실제 LLM 트리거 검증은 Nova 개발자 전용 dev/skills/field-test/로 수동 수행 (사용자 플러그인에는 미포함).

4. 동기화 체크리스트 (CLAUDE.md와 일치)

새 스킬 추가 시:

hooks/session-start.sh 커맨드 목록 영향 여부 확인 (커맨드 아니면 대개 불필요)
tests/test-scripts.sh의 description lint 통과 확인
docs/nova-meta.json — bump-version.sh가 자동 재생성 (수동 편집 금지)
tests/skill-triggering/prompts/{name}-positive.txt 제출

안티패턴

description을 짧게 만들려고 트리거를 생략한다 → Claude가 언제 쓸지 판단 못 함
"5인 적대 평가자", "3단 파이프라인" 같은 숫자 홍보 → 본문 스킵 유발
여러 목적을 한 스킬에 몰아넣는다 → 트리거 모호, 본문 비대

근거 (왜 이 규약이 존재하는가)

obra/superpowers/skills/writing-skills/SKILL.md — "Testing revealed that when a description summarizes the skill's workflow, Claude may follow the description instead of reading the full skill content"
memory/project_nova_competitive_analysis_2026_04_23.md — 경쟁 분석 결과 9개 Nova SKILL 중 5개가 이 안티패턴에 해당, Tier 1.1에서 일괄 리팩터
Nova 5기둥 중 협업 기둥 — 스킬이 제 때 발동하지 않으면 에이전트 협업이 붕괴한다