Fibo Skills
FiboCode의 내장 터미널에서 Agent CLI(Claude Code, Codex 또는 Skills를 지원하는 Agent CLI)를 사용할 때 Fibo Skills는 그 Agent에게 FiboCode의 사양 중심 워크플로를 알려 줍니다. 선택 사항이므로 없어도 터미널은 작동하지만, 설치하면 Agent가 FiboCode와 동일한 brainstorm → spec → plan → execute → sync 흐름을 사용해 결과가 코드베이스와 멀어지지 않고 .fibo/ 문서 시스템에 남습니다.
Skills는 에이전트가 필요할 때 불러오는 패키지화된 지침입니다. Fibo Skills는 오픈 소스이며 FiboCode가 아니라 사용자의 에이전트에 설치됩니다.
Skills 저장소: github.com/Alenkz12/FiboSkills
Skill 구성
서로 무관한 명령 모음이 아니라 하나의 워크플로입니다. 처음 다섯 skills는 단계마다 다음 단계로 작업을 넘기고, 마지막 두 개는 독립적으로 작동합니다.
| Skill | 단계 | 용도 |
|---|---|---|
fibo-brainstorming | 요구를 명확히 하기 | 모호한 의도를 승인된 AC 목록으로 바꿈 |
fibo-writing-plan | 접근 방식 결정 | spec에서 design.md와 plan.md를 생성 |
fibo-executing-plan | 코드 작성 | plan의 작업을 순서대로 하나씩 실행 |
fibo-recording-diff | 기록 남기기 | 실제 diff를 읽기 쉬운 hunk별 diff.md로 변환 |
fibo-conventions | 규칙 유지 | 이름, 주석, 문서, commit sync를 위한 단일 규칙 집합 |
fibo-code-analysis | 코드 읽기 | 계층화된 file → structure → folder 분석 미러 생성 |
fibo-skills-reviewer | 자체 유지보수 | skill 파일 자체의 문구를 감사 |
fibo-brainstorming — 먼저 요구 사항을 확정
외부에 보이는 동작을 변경하기 전에 호출합니다. 가능하면 선택지를 제시하면서 한 번에 한 질문씩 묻고, “기능이 필요하다”는 요청을 EARS 구문의 승인 기준 목록으로 좁힌 뒤 명시적인 승인 후에만 spec.md를 작성합니다. 프로덕션 코드를 작성하지 않고 테스트나 commit도 하지 않습니다. 유일한 역할은 모호함을 제거하는 것입니다.
fibo-writing-plan — spec을 설계와 작업으로 전환
spec이 승인된 뒤 호출합니다. spec.md를 읽고 같은 디렉터리에 design.md(HOW, 모든 설계 결정에 ↔ AC 표시)와 plan.md(각 작업이 관련 AC, 파일, 검증 방법을 명시하는 목록)를 만듭니다. AC 커버리지가 100% 미만이거나 존재하지 않는 AC를 참조하는 작업이 있으면 디스크에 쓰지 않습니다.
fibo-executing-plan — plan을 엄격히 직렬 실행
plan.md의 작업을 병렬로 실행하지 않고 하나씩 수행해 동일한 파일에서 충돌하지 않게 합니다. 각 작업은 자신의 목록에 있는 파일만 변경할 수 있습니다. 실패하면 스스로 되돌리지 않고 중단한 뒤 건너뛰기 / 중단 / 재시도를 묻습니다. 모두 끝나면 구현 보고서를 출력하고 바로 diff 기록과 문서 동기화로 넘어갑니다.
fibo-recording-diff — 변경을 읽기 쉽게 만들기
구현 후 호출합니다. 실제 diff를 hunk 수준 설명으로 변환하고, 변경된 파일을 일관된 읽기 순서로 정렬하며, 각 hunk에 코드 앵커와 필요한 경우 Mermaid 로직 보기를 붙이고, hunk가 존재하는 이유와 주변 로직과의 연결을 설명합니다. 코드나 AC는 변경하지 않습니다.
fibo-conventions — 문서와 주석을 하나의 목소리로
Markdown을 작성하거나 코드 주석을 추가하거나 .fibo/docs/ 아래에 파일을 만들 때 적용합니다. Mermaid 사용법, code / text / graph 태그 형식, 경로 규칙, 이름 규칙, 주석-코드 동기화, .fibo/index.json에 기준을 기록하는 commit 전 일괄 문서 동기화를 다룹니다.
fibo-code-analysis — 구조화된 분석 출력
.fibo/analysis 아래에 구조화된 분석을 생성하고 FiboCode 자체의 분석 파이프라인인 prompt 선택, 동시성, 디스크 배치, 언어별 prompt를 이해하거나 확장할 때 사용합니다. 이 skill과 앱 안의 Code Analysis는 같은 코드 이해 방식으로 들어가는 두 입구입니다.
fibo-skills-reviewer — skills 자체 점검
skill 파일의 문구만 감사합니다. 논리적 모순과 누락, 불분명한 참조, 중복으로 인한 불일치, 노출된 유지보수 메모를 찾습니다. “규칙이 무엇인지”가 아니라 “어떻게 표현하는지”만 바꾸며, 실제 규칙 충돌을 발견하면 멈추고 사용자에게 결정을 맡깁니다.
설치: Claude Code
Claude Code는 .claude/skills/ 디렉터리에서 skills를 읽습니다. 프로젝트 수준은 하나의 코드베이스에만 적용되고 사용자 수준은 모든 곳에서 사용할 수 있습니다.
# Project level (recommended: travels with the repo, so team and agent share one rule set)
git clone https://github.com/Alenkz12/FiboSkills .claude/skills
# Or user level (available in every project)
git clone https://github.com/Alenkz12/FiboSkills ~/.claude/skills
Claude Code를 다시 시작하거나 새 세션을 열면 fibo-* skills가 목록에 나타납니다. /fibo-brainstorming으로 호출하거나 작업을 설명해 에이전트가 적절한 단계를 선택하게 하세요.
설치: Codex와 기타 에이전트
skill 파일은 YAML frontmatter가 있는 일반 Markdown이므로 에이전트 간에 옮길 수 있습니다. 원하는 위치에 clone하세요.
git clone https://github.com/Alenkz12/FiboSkills
- 기본 skills 메커니즘이 있는 에이전트 — 해당 에이전트의 문서에 따라 skills 디렉터리를 clone 위치로 지정합니다.
- 지침 파일만 읽는 에이전트 — 올바른 단계에서 skills를 읽도록 그 파일(예:
AGENTS.md)에 위치와 목적을 설명합니다.
적용 여부 확인
FiboCode 내장 터미널에서 에이전트에게 “이 저장소에 구성 옵션을 추가해 줘” 같은 작은 작업을 요청하세요. skills가 활성화되어 있으면 곧바로 코드를 수정하지 않고 먼저 brainstorming 단계를 열어 AC를 확인한 뒤 spec.md, design.md, plan.md를 .fibo/docs/specs/<feature>/ 아래에 남깁니다.
최신 상태 유지
skills는 git clone에 있으므로 최신 버전을 가져오는 데 한 줄이면 충분합니다.
cd .claude/skills && git pull
도움 받기
- 전체 skill 구성은 github.com/Alenkz12/FiboSkills에서 확인하세요.
- GitHub Discussions에서 질문하세요.
- issue tracker에 문제를 보고하세요.