Menú
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| 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 구조 |
티스토리 기술 블로그 글쓰기 도우미. 한국어 기술 문서 작성과 티스토리 플랫폼 최적화를 지원합니다. 이 스킬은 다음 상황에서 사용하세요: - 기술 블로그 글 구조를 잡고 싶을 때 - 코드 설명 글을 작성할 때 - 한국어 기술 문서 작성 시 표현 교정이 필요할 때 - 티스토리에 최적화된 마크다운/HTML 형식이 필요할 때 - TIL, 튜토리얼, 트러블슈팅, 딥다이브 글을 작성할 때 - SEO 최적화 (제목, 설명, 태그)가 필요할 때
CTO 수준의 프론트엔드 과제 평가용 Codex skill. 채용 과제를 체계적으로 분석하고 객관적인 평가 리포트를 생성합니다. 사용 상황: - 프론트엔드 채용 과제를 평가할 때 - 코드 품질, 아키텍처, 테스트 전략을 분석할 때 - 제한시간(2일/7일)에 따른 기대치 조정이 필요할 때 - 객관적인 채용 판단 근거가 필요할 때 - 지원자에게 피드백을 제공할 때
코드베이스와 Codex skill의 에이전트 친화도(harness)를 12개 원칙으로 진단하고 개선안을 제안합니다. 사용 상황: 신규 환경 구축(Setup), 현 상태 점검(Audit), drift 정리(Maintenance), skill 품질 검사(Self).
CTO 수준의 프론트엔드 과제 평가 도우미. 채용 과제를 체계적으로 분석하고 객관적인 평가 리포트를 생성합니다. 이 스킬은 다음 상황에서 사용하세요: - 프론트엔드 채용 과제를 평가할 때 - 코드 품질, 아키텍처, 테스트 전략을 분석할 때 - 제한시간(2일/7일)에 따른 기대치 조정이 필요할 때 - 객관적인 채용 판단 근거가 필요할 때 - 지원자에게 피드백을 제공할 때