Agent 生成器
- 作者仓库星标 209
- 作者更新于 实时读取
- 作者仓库 cowork-plugins
- 领域
- 工程开发
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @modu-ai · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: skill-builder
description: | harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄…
category: 工程开发
runtime: 无特殊运行时
---
# skill-builder 输出预览
## PART A: 任务判断
- 适用问题:代码实现、重构、调试或代码审查。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“개요 / 트리거 키워드 / 워크플로우”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于代码实现、重构、调试或代码审查,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“개요 / 트리거 키워드 / 워크플로우”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 原文出现了 `/harness` 这类斜杠命令;如果你的 Agent 支持命令触发,优先用命令开场,再补充目标和边界。
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件。
先用一个小任务确认它会围绕“개요 / 트리거 키워드 / 워크플로우”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: skill-builder
description: | harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄…
category: 工程开发
source: modu-ai/cowork-plugins
---
# skill-builder
## 什么时候使用
- 把工程方向的常用动作沉淀成 Agent 可调用的技能 适合处理工程开发场景下的代码实现、调试、重构、测试或代码审查,核心价值是把输入、判断、执行、验证和交付边界固定下来,避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代…
- 面向代码实现、重构、调试或代码审查,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「개요 / 트리거 키워드 / 워크플로우」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "skill-builder" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> 개요 / 트리거 키워드 / 워크플로우
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} Skill Builder — 6-Phase 스킬 생성 워크플로우
moai-core | revfactory/harness 방법론 기반 스킬 생성
개요
harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄이고, 체계적인 생성 프로세스를 통해 일관된 품질의 스킬을 생산합니다.
이름 이력: v1.3.x까지
skill-forge로 제공되던 스킬이 v1.5.x에서skill-builder로 이름 변경되었습니다. 별칭은 유지되지 않으며 모든 참조는skill-builder로 갱신해야 합니다.
트리거 키워드
스킬 생성 스킬 제작 skill-builder 새 스킬 만들기 스킬 추가 신규 스킬 harness 워크플로우
워크플로우
Phase 1: Requirements → 사용자 의도 분석, 트리거 키워드 정의
Phase 1.5: Research → 공식 자료·베스트 프랙티스 외부 조사 (WebSearch + Context7) ★ v1.6.0
Phase 2: Architecture → 에이전트 패턴 선택 (6종 중 매핑)
Phase 3: Skill Draft → skill-template 기반 SKILL.md 초안 + ## 출처 섹션
Phase 4: Test Gen → 테스트 프롬프트 2-3개 + 기대 출력 정의
Phase 5: Validation → 4차원 루브릭 스코어링 (skill-tester 본문 §스코어링 루브릭)
Phase 6: Review → 품질 게이트 통과 확인, 파일 배치
실행 규칙
Phase 1: Requirements (요구사항 분석)
사용자의 자연어 요청에서 스킬 요구사항을 추출합니다.
필수 수집 항목:
| 항목 | 질문 | 예시 |
|---|---|---|
| 목적 | "이 스킬이 해결할 문제는?" | "영업 제안서를 자동 생성하고 싶다" |
| 타겟 플러그인 | "어느 플러그인에 배치할까?" | moai-business |
| 입력 | "사용자가 무엇을 입력하나?" | 회사명, 타겟 산업, 제품 정보 |
| 출력 | "어떤 산출물을 기대하나?" | 제안서 DOCX 파일 |
| 복잡도 | "스킬이 얼마나 복잡한가?" | Standard (50-150줄) |
출력물: 요구사항 문서 (인메모리, AskUserQuestion으로 확인)
Phase 1.5: Research (외부 자료 조사) ★ v1.6.0 신설
스킬 도메인의 공식 자료·표준 양식·베스트 프랙티스를 조사하여 SKILL.md의 정확성과 권위를 확보합니다.
조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무):
- 한국 법규·표준 양식 관련 (세무·노무·계약·채용·의료 등)
- 외부 라이브러리·SDK·API·CLI 활용
- 글로벌 베스트 프랙티스 인용이 필요한 도메인 (B2B SaaS·HR·BI·DevOps 등)
- 정량 수치·통계 데이터·시장 규모 인용
조사 절차:
WebSearch 2-4회 (병렬 권장)
- 한국어 쿼리 1-2회:
"<도메인> <핵심 키워드> <연도>"형식 (예: "한국 채용절차법 NCS 2026") - 영어 쿼리 1-2회 (글로벌 베스트 프랙티스 인용 시):
"<topic> best practice <year>"형식 - 검색 결과의 최신성 확인 (2년 이내 자료 우선)
- 한국어 쿼리 1-2회:
Context7 MCP (라이브러리·SDK·CLI 관련 스킬일 때)
resolve-library-id→get-library-docs순서- 최신 API/CLI 변경사항·deprecation 확인
- 학습 데이터 cutoff 보완
도메인별 공식 출처 화이트리스트 (우선 인용):
도메인 1차 권장 출처 한국 세무·재무 국세청 nts.go.kr, 홈택스 hometax.go.kr, DART dart.fss.or.kr 한국 노무·채용 고용노동부 moel.go.kr, NCS ncs.go.kr, 한국노동연구원 kli.re.kr 한국 의료·건강 식약처 mfds.go.kr, 보건복지부 mohw.go.kr, 건강보험공단 nhis.or.kr 한국 정부지원 K-Startup k-startup.go.kr, BIZINFO bizinfo.go.kr 한국 통계·시장 KOSIS kosis.kr, 한국은행 ECOS ecos.bok.or.kr 한국 법률 국가법령정보센터 law.go.kr, 대법원 종합법률정보 glaw.scourt.go.kr 글로벌 회계 표준 K-IFRS, IFRS Foundation ifrs.org 글로벌 채용 규제 EEOC eeoc.gov, NYC Local Law 144, ISO 42001:2023 글로벌 SaaS BP 제품 공식 문서(HubSpot·Salesforce·Greenhouse 등) + 업계 리딩 블로그 출처 보존:
- 조사 결과의 URL·발행일·핵심 인용 문장을 인메모리에 보존
- Phase 3에서 SKILL.md
## 출처섹션에 markdown hyperlink 형식으로 인용 - 정량 수치는 출처 인라인 표기 또는
[추정]태그 강제
산출물: research notes (인메모리, Phase 3 입력으로 전달)
금지:
- 출처 없는 정량 수치 인용 (반드시 출처 명시 또는
[추정]태그) - 한국 도메인 스킬에 한국 공식 출처 누락
- 라이브러리·SDK 관련 스킬에 Context7 MCP 미사용 (가용 시)
- 구버전 자료 인용 (3년 초과 시 최신 자료 재검색)
스킵 조건 (Phase 1.5 생략 가능):
- 단순 포맷 변환·텍스트 처리 스킬 (도메인 지식 불필요)
- 사용자가 명시적으로
--skip-research플래그 지정 - 기존 cowork 스킬의 minor 개선·트리거 키워드 조정만
Phase 2: Architecture (아키텍처 선택)
6개 에이전트 패턴 중 최적 패턴을 선택합니다.
| 패턴 | 적용 시나리오 | 스킬 예시 |
|---|---|---|
| Pipeline | 순차 처리, 각 단계 출력이 다음 입력 | docx-generator, blog |
| Fan-out/Fan-in | 병렬 분석 후 결과 통합 | ux-designer, market-analysis |
| Expert Pool | 다 도메인 전문 지식 결합 | consulting-brief, startup-launchpad |
| Producer-Reviewer | 생성 + 품질 검토 순환 | sales-playbook, copywriting |
| Supervisor | 다수 전문 스킬 오케스트레이션 | ai-diagnostic, project |
| Hierarchical Delegation | 복잡 작업 계층적 분해 | startup-launchpad |
선택 기준: 스킬의 워크플로우 단계 수, 병렬성 여부, 품질 검증 필요성을 기준으로 판단합니다.
출력물: 선택된 패턴 + 근거 (1-2문장)
Phase 3: Skill Draft (스킬 초안 생성)
skill-template 템플릿을 기반으로 SKILL.md 초안을 생성합니다.
필수 적용:
- skill-template의 필수 섹션 구조 사용
- Frontmatter는
name,description만 포함 (metadata 금지) - 트리거 키워드는 기존 73개 스킬과 중복되지 않도록 검사
- 사용 예시 최소 2개 포함
- 관련 스킬 섹션에 before/after/alternative 관계 명시
## 출처섹션 의무: Phase 1.5에서 수집한 URL·인용을 markdown hyperlink로 명시 (Phase 1.5 적용 스킬)- 정량 수치 인용 규칙: 모든 수치는 출처 인라인 표기 또는
[추정]태그
참조: moai-core/skills/skill-tester/SKILL.md §스코어링 루브릭 (품질 기준 single source)
참조: moai-core/skills/skill-template/SKILL.md (템플릿)
출력물: <target-plugin>/skills/<skill-name>/SKILL.md 초안
Phase 4: Test Generation (테스트 생성)
스킬 검증용 테스트 케이스를 생성합니다.
테스트 구성:
tests:
- name: "happy-path"
prompt: "<대표적인 사용 프롬프트>"
expected_output:
format: "<출력 형식>"
contains: ["<필수 포함 내용>"]
not_contains: ["<금지 내용>"]
- name: "edge-case"
prompt: "<경계 조건 프롬프트>"
expected_output:
handles_gracefully: true
fallback_behavior: "<설명>"
- name: "complex-input"
prompt: "<복잡한 입력 프롬프트>"
expected_output:
completeness: "모든 요구사항 충족"
출력물: <skill-dir>/tests/test-cases.yaml
Phase 5: Validation (품질 검증)
4차원 루브릭으로 스킬을 평가합니다.
| 차원 | 가중치 | 평가 |
|---|---|---|
| Correctness | 30% | 목적 달성 여부 |
| Completeness | 25% | 에지 케이스 커버 |
| Clarity | 25% | 사용자 이해 가능성 |
| Efficiency | 20% | 토큰 대비 품질 |
통과 기준: 가중 평균 >= 0.70, 모든 차원 >= 0.50
미달 시: Phase 3으로 돌아가서 부족한 차원을 보완합니다. 최대 3회 반복.
참조: moai-core/skills/skill-tester/SKILL.md §스코어링 루브릭 (anchor 점수표 + 평가 절차)
Phase 6: Review (최종 검토)
배포 전 최종 체크리스트를 실행합니다.
체크리스트:
- Frontmatter 형식 준수 (name, description만, metadata 없음)
- 필수 섹션 모두 존재 (개요, 트리거, 워크플로우, 예시, 출력, 주의사항, 관련 스킬)
- 트리거 키워드가 기존 스킬과 중복되지 않음
- plugin.json 버전이 업데이트 필요한 경우 안내
- 스킬 체인 관계가 CLAUDE.local.md §3-3과 일치 (해당 시)
- 테스트 케이스가 생성됨
- 루브릭 스코어 0.70 이상 통과
-
## 출처섹션 존재 (Phase 1.5 적용 스킬,--skip-research미지정 시) - 정량 수치 모두 출처 또는
[추정]태그 (Phase 1.5 적용 스킬)
배치: <target-plugin>/skills/<skill-name>/SKILL.md 에 최종 파일을 배치합니다.
사용 예시
예시 1: 신규 스킬 생성
"moai-business에 영업 제안서 자동 생성 스킬을 만들어줘. 회사명과 타겟 기업 입력하면 제안서 DOCX가 나오게"
예시 2: Vibe 갭 스킬 생성
"skill-builder로 moai-product에 UX 디자인 분석 스킬을 만들어줘. Vibe Designing 기능 참고해서"
출력 형식
| 산출물 | 위치 | 설명 |
|---|---|---|
| SKILL.md | <plugin>/skills/<name>/SKILL.md |
완성된 스킬 정의 |
| test-cases.yaml | <plugin>/skills/<name>/tests/ |
테스트 케이스 |
| score-report | 인메모리 | 루브릭 스코어 보고서 |
주의사항
- 기존 스킬 수정이 아닌 신규 스킬 생성에만 사용합니다
- 플러그인 디렉토리(
moai-*)가 존재하는지 사전 확인이 필요합니다 - 스킬 생성 후 plugin.json 버전 bump는 릴리스 절차(CLAUDE.local.md §1)에서 일괄 처리합니다
- 트리거 키워드 중복 시 기존 스킬의 description을 확인하여 명확히 구분해야 합니다
관련 스킬
| 스킬 | 관계 | 설명 |
|---|---|---|
| skill-template | before | 템플릿 구조를 제공하는 기반 스킬 |
| skill-tester | after | 생성된 스킬의 테스트 실행 + 루브릭 스코어링 |
| ai-slop-reviewer | after | 스킬 본문의 AI 패턴 검수 (선택) |
관련 커맨드
| 커맨드 | 설명 |
|---|---|
/harness |
new→test→review 자동 연쇄 (이 스킬 + skill-tester + ai-slop-reviewer 오케스트레이션) |
Source: revfactory/harness 6-Phase workflow (Apache 2.0) + MoAI adaptation
Changelog
- 1.6.0 (2026-05-01): Phase 1.5 Research 신설 — 외부 자료 조사(WebSearch·Context7) 의무화, 도메인별 공식 출처 화이트리스트 추가,
## 출처섹션 의무화 + 정량 수치 출처/[추정]태그 강제 - 1.5.x: skill-forge → skill-builder 이름 변경
- 이전: harness 6-Phase 워크플로우 흡수
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核