القائمة
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
티스토리 기술 블로그 글쓰기 도우미. 한국어 기술 문서 작성과 티스토리 플랫폼 최적화를 지원합니다. 이 스킬은 다음 상황에서 사용하세요: - 기술 블로그 글 구조를 잡고 싶을 때 - 코드 설명 글을 작성할 때 - 한국어 기술 문서 작성 시 표현 교정이 필요할 때 - 티스토리에 최적화된 마크다운/HTML 형식이 필요할 때 - TIL, 튜토리얼, 트러블슈팅, 딥다이브 글을 작성할 때 - SEO 최적화 (제목, 설명, 태그)가 필요할 때
CTO 수준의 프론트엔드 과제 평가용 Codex skill. 채용 과제를 체계적으로 분석하고 객관적인 평가 리포트를 생성합니다. 사용 상황: - 프론트엔드 채용 과제를 평가할 때 - 코드 품질, 아키텍처, 테스트 전략을 분석할 때 - 제한시간(2일/7일)에 따른 기대치 조정이 필요할 때 - 객관적인 채용 판단 근거가 필요할 때 - 지원자에게 피드백을 제공할 때
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
CTO 수준의 프론트엔드 과제 평가 도우미. 채용 과제를 체계적으로 분석하고 객관적인 평가 리포트를 생성합니다. 이 스킬은 다음 상황에서 사용하세요: - 프론트엔드 채용 과제를 평가할 때 - 코드 품질, 아키텍처, 테스트 전략을 분석할 때 - 제한시간(2일/7일)에 따른 기대치 조정이 필요할 때 - 객관적인 채용 판단 근거가 필요할 때 - 지원자에게 피드백을 제공할 때
| name | harness-diagnostics |
| description | 코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self). |
| version | 2.1.0 |
에이전트 협업 환경의 성숙도를 평가하고 실행 가능한 리포트를 생성합니다.
| 모드 | 트리거 | 목적 | 깊이 | 워크플로우 |
|---|---|---|---|---|
| Setup | 새 프로젝트, "환경 구축" | 초기 harness 구성 제안 | Standard | references/setup-workflow.md |
| Audit | "진단", "점검" | 점수화 + 개선 로드맵 | Quick/Standard/Deep | references/audit-workflow.md |
| Maintenance | "drift", "정리" | 변경 감지 + GC 제안 | Standard | references/maintenance-workflow.md |
| Remediate | "개선", "자동 수정", "loop" | Audit→Fix→Re-Audit 루프 | Standard/Deep | references/remediate-workflow.md |
깊이 프로필 상세는 references/depth-profiles.md를 참조한다.
Remediate 모드는 read-only 기본 원칙의 예외로, 명시적 사용자 동의 후에만 파일을 수정한다.
모드가 애매하면 사용자에게 확인한다.
초기 프로젝트에서의 사용 순서는 references/recommended-flow.md를 참조한다.
| 대상 | 판별 기준 | 체크리스트 |
|---|---|---|
| 코드베이스 | git repo + 소스 존재 | references/codebase-checklist.md |
| Skill | .codex/skills/*/SKILL.md | references/skill-checklist.md |
| Self | 본 skill 자체 | references/skill-checklist.md |
references/principles.md를 기준으로 P1~P12를 0-10점으로 평가한다.
P1 Agent Entry Point, P2 Map, P3 Invariant, P4 Convention, P5 Progressive Disclosure,
P6 Layered, P7 Garbage Collection, P8 Observability, P9 Knowledge, P10 Reproducibility, P11 Modularity, P12 Self-Documentation.
| 등급 | 점수 | 의미 |
|---|---|---|
| L1 | 0-19 | None |
| L2 | 20-39 | Basic |
| L3 | 40-59 | Structured |
| L4 | 60-79 | Optimized |
| L5 | 80-100 | Autonomous |
가중치/산식은 references/maturity-framework.md를 따른다.
references/report-template.md 형식으로 리포트 출력전체 스크립트/템플릿 목록은 references/tools-index.md를 참조한다.
핵심 검증 명령:
bash scripts/self-audit.sh — 구조 + 런타임 통합 검증bash scripts/adversarial-verify.sh — 반증 기반 신뢰도 검증node scripts/calculate-score.js references/score-template.json — 점수 계산| 파일 | 역할 |
|---|---|
references/principles.md | 12원칙 판단 기준 |
references/maturity-framework.md | 차원/가중치/점수 산식 |
references/codebase-checklist.md | 코드베이스 체크리스트 (84항목) |
references/skill-checklist.md | Skill 체크리스트 (51항목) |
references/setup-workflow.md | Setup 워크플로우 |
references/audit-workflow.md | Audit 워크플로우 |
references/maintenance-workflow.md | Maintenance 워크플로우 |
references/verification-workflow.md | 검증/로그 운영 워크플로우 |
references/report-template.md | 리포트 출력 형식 |
references/remediate-workflow.md | Remediate 워크플로우 |
references/fix-catalog.md | 원칙별 개선 액션 카탈로그 |
references/contract-template.md | Sprint Contract 형식 |
references/score-template.md | 차원/종합 점수 계산 표 |
references/score-template.json | 자동 계산 입력 스키마 |
references/recommended-flow.md | 권장 사용 흐름 상세 |
references/layer-dependency-rules.md | 레이어 의존성 규칙 |
references/adr-001-scoring-weights.md | ADR: 차원 가중치 결정 근거 |
references/adr-002-checklist-item-counts.md | ADR: 체크리스트 항목 수 근거 |
| 파일 | 내용 |
|---|---|
examples/sample-agents-md.md | AGENTS.md 예시 |
examples/sample-setup-report.md | Setup 리포트 예시 |
examples/sample-report.md | Audit 리포트 예시 |
examples/sample-docs-structure.md | 권장 docs 구조 |