skill-refinement
Skill 사용 후 개선 제안. ledger 분석으로 어느 skill 이 자주 실패 / open_question 다발 / 비효율인지 식별. Chief 가 retrospective 후 호출.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 25
- Forks
- 2
01 前言 Front Matter
- name
- skill-refinement
- team
- _skill
- tier
- leader
- used_by
- [ "chief" ]
- category
- agile
- triggers
- { "keyword": [ "skill 개선", "skill refinement", "skill 평가" ] }
- description
- Skill 사용 후 개선 제안. ledger 분석으로 어느 skill 이 자주 실패 / open_question 다발 / 비효율인지 식별. Chief 가 retrospective 후 호출.
- dev_capability
- false
- pm_conventions
- { "hard_gate": false, "post_labeling": true, "anti_sycophancy": true, "minimum_approaches": 1 }
- schema_version
- 2
03 SKILL.md 正文
Skill Refinement Skill
Chief 자가학습 루프의 일부. 어떤 skill 이 잘 작동하고, 어떤 skill 이 개선 필요한지 평가.
입력
- 평가 대상 period
<org>/memory/ledger/<task-id>.jsonl— skill 호출 trace<org>/memory/open-questions/<id>.json— 미해결/blocking 비율<org>/memory/agent-costs.jsonl— skill 별 cost
평가 차원
per_skill_metrics:
skill_name: <name>
invocation_count: <N>
avg_duration_ms: <N>
avg_cost_usd: <N>
hard_gate_failure_rate: <%> # gate 통과 못 한 비율
open_question_rate: <%> # 호출당 발생한 open_question 수
rework_rate: <%> # 같은 task 에서 재호출된 비율
confidence_delta_avg: <+/-> # 호출 전후 confidence 변화
Failure Patterns
patterns:
- skill: problem-definition
issue: "TDCC P4 단계 unknown 필드 too frequent (62%)"
root_cause_hypothesis: "archive context 너무 짧음 (avg N=4 entries)"
fix_candidates:
- "기본 archive window 확대 (4→8 entries)"
- "TDCC P4 reasoning step skip threshold 도입"
출력
period: "..."
top_3_high_friction_skills: [...]
top_3_efficient_skills: [...]
refinement_proposals:
- skill: "..."
proposal: "..."
expected_impact: "..."
effort: small | medium | large
approval_required: founder | chief_auto
Anti-Sycophancy
- ❌ "skill 들이 잘 작동합니다"
- ✅ "problem-definition 의 P4 단계가 62% 빈도로 unknown 필드 발생. archive context 확대로 개선 가능 (예상 -30%)."
Reference
- v1.1 PRD §5.2 RETROSPECT + §1.1 #7 (자가학습 메커니즘)
04 同仓库更多 Skills
xyz-hypothesis
검증 가능한 가설 프레임워크 — "[X%] of [Y segment] will [Z behavior] within [T period], because [R]". 입장+반증 조건 강제, 최소 2개 접근, V/U/V/F 가정 분류. v1.3.5 에서 problem-definition P5 를 독립 skill 로 분리.
workflow-refinement
Workflow 종료 시 개선 제안. stage 의존성 / handoff 효율 / 평균 cycle time 분석. Chief 가 RETROSPECT 에서 호출.
workflow-manager
workflow(org 단위 조립물 — stage DAG 가 워크스페이스의 skill·agent 를 참조)의 대화형 매니저이자 작성 표준의 권위. 의도에서 workflow YAML 을 합성·검토·개선하도록 안내하고, 좋은 워크플로 노하우(본질 원칙=목표·근거·방법→결론·핸드오프 / DAG 무순환 / exit_criteria measurable / 기획 3대 편향 가드)를 보유한다. 결정적 동작(new/list/show/validate)은 solosquad workflow * 헬퍼로 위임. 사용 시점 — 워크플로를 새로 만들·고칠 때, 또는 다른 워크플로의 작성 품질을 판단할 때.
wbs
마일스톤 → WBS (Work Breakdown Structure) 분해. PM 핵심 산출물. team OKR 의 KR 을 분기→주→일 단위 작업으로 변환. dependency graph + critical path 식별.
triage
Chief 의 과제 분류 도구. 사용자 입력을 4-way 분류 (discussion / workflow / cron / goal) + Educational Nudge (불명확 시 KNOWLEDGE 가이드 선제시).
skill-manager
skill(SKILL.md)의 대화형 매니저이자 **작성 표준의 권위(authoring authority)**. 새 skill 생성·검토·개선을 Chief 세션 안에서 안내하고, 좋은 SKILL.md 작성 노하우(description 공식·정량 한도·번들 구조·eval 검증·frontmatter 필드 감사)를 보유한다. 결정적 동작(scaffold/list/show/validate)은 `solosquad skill *` 헬퍼로 위임하고, 의도→초안·품질 검토·개선은 대화로 진행한다. 사용 시점 — skill 을 새로 만들 때, 기존 skill 을 고칠 때, 또는 다른 skill 의 작성 품질을 판단할 때. v1.3.6 — 코드 백엔드 `src/bot/skill-manager.ts` 위에 작성 권위를 얹음.