AGENT SKILL

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

Adelie-Squad
Adelie-Squad/solosquad

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 로 분리.

★ 25
Adelie-Squad
Adelie-Squad/solosquad

workflow-refinement

Workflow 종료 시 개선 제안. stage 의존성 / handoff 효율 / 평균 cycle time 분석. Chief 가 RETROSPECT 에서 호출.

Skill与智能体开发
★ 25
Adelie-Squad
Adelie-Squad/solosquad

workflow-manager

workflow(org 단위 조립물 — stage DAG 가 워크스페이스의 skill·agent 를 참조)의 대화형 매니저이자 작성 표준의 권위. 의도에서 workflow YAML 을 합성·검토·개선하도록 안내하고, 좋은 워크플로 노하우(본질 원칙=목표·근거·방법→결론·핸드오프 / DAG 무순환 / exit_criteria measurable / 기획 3대 편향 가드)를 보유한다. 결정적 동작(new/list/show/validate)은 solosquad workflow * 헬퍼로 위임. 사용 시점 — 워크플로를 새로 만들·고칠 때, 또는 다른 워크플로의 작성 품질을 판단할 때.

Skill与智能体开发
★ 25
Adelie-Squad
Adelie-Squad/solosquad

wbs

마일스톤 → WBS (Work Breakdown Structure) 분해. PM 핵심 산출물. team OKR 의 KR 을 분기→주→일 단위 작업으로 변환. dependency graph + critical path 식별.

★ 25
Adelie-Squad
Adelie-Squad/solosquad

triage

Chief 의 과제 분류 도구. 사용자 입력을 4-way 분류 (discussion / workflow / cron / goal) + Educational Nudge (불명확 시 KNOWLEDGE 가이드 선제시).

Skill与智能体开发
★ 25
Adelie-Squad
Adelie-Squad/solosquad

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` 위에 작성 권위를 얹음.

Skill与智能体开发
★ 25