Skip to content

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Saylog Design Skills

Dou 제품의 디자인·UI/UX 이슈 관리·사용자 매뉴얼 제작에 사용하는 public agent skills 저장소입니다.

설치

이 저장소는 public GitHub 저장소이므로 별도 저장소 권한이나 SSH 인증 없이 skill을 설치할 수 있습니다.

권장 설치 방법

저장소 shorthand:

npx skills add douinc/dou-design-skills@<skill-name>

예시:

npx skills add douinc/dou-design-skills@dou-product-design

Git URL 설치

전체 Git URL을 사용하려면 HTTPS 방식을 권장합니다.

npx skills add https://github.com/douinc/dou-design-skills.git --skill <skill-name>

dou-product-design에서 GitHub 이슈 연결 작업까지 하려면 두 skill을 함께 설치합니다.

npx skills add https://github.com/douinc/dou-design-skills.git --skill dou-product-design --skill saylog-uxui-issues

Skill 목록

Skill 용도
dou-product-brief 신규 제품·기능 기획의 구체화부터 plan.md·IA·화면별 브리프까지 만드는 워크플로우
dou-product-design Next.js + shadcn/ui 기반 Dou 제품 화면의 스펙·와이어프레임·직접 구현 워크플로우
saylog-uxui-issues Saylog 제품 UI/UX 이슈의 초안·등록, 하위 이슈 관계와 GitHub Project 상태 관리
saylog-ux-writing-korean Saylog UI 문구의 톤 규칙과 기존 문구 대조 절차 (앱·웹 콘솔·새록 라이브 공통)
saylog-manual-authoring Saylog 화면 스크린샷과 설명으로 A4 사용자 매뉴얼을 만들거나 수정하는 워크플로우

Skill 간 의존성

dou-product-brief

  • 제품 정책·도메인 문서. 프로젝트 설정의 design_config.domain_guide가 가리키는 곳입니다.
  • 기획 산출물을 저장할 폴더. 프로젝트 설정의 design_config.planning_docs_location입니다.
  • 화면을 만드는 단계로 넘어가면 dou-product-design으로 이어집니다.

dou-product-design

  • Dou 제품 저장소의 docs/design-harness.md와 docs/ia.md
  • 프로젝트 설정의 product_design_workflow.design_system에 지정된 dou-design-system
  • GitHub 이슈를 연결하는 작업에서는 saylog-uxui-issues 규칙과 GitHub 권한
  • UI 문구를 쓰거나 고칠 때는 프로젝트 설정의 product_design_workflow.ux_writing_skill에 지정된 스킬 (Saylog는 saylog-ux-writing-korean)

saylog-uxui-issues

제품 영역에 따라 다음 private 저장소를 확인하거나 이슈 등록 대상으로 사용합니다.

  • douinc/saylog
  • douinc/carevoice
  • douinc/saylog-design
  • douinc/saylog-console-design
  • douinc/saylog-live

GitHub 이슈 생성·수정, 하위 이슈 연결, Project 상태 변경에는 해당 저장소와 Project에 필요한 권한이 있어야 합니다.

saylog-ux-writing-korean

기존 문구 대조에는 제품 리포의 docs/design-harness.md가 가리키는 실제 구현 소스와 baseline 캡처가 필요합니다. Saylog는 douinc/carevoice의 flutter · web · saylog-live입니다.

saylog-manual-authoring

Saylog 매뉴얼 작업에는 다음이 필요합니다.

  • douinc/saylog wiki의 컨텍스트 문서 (git clone https://github.com/douinc/saylog.wiki.git). 예전 경로였던 douinc/carevoice의 docs/shared는 없어졌습니다.
  • douinc/saylog-manuals의 매뉴얼 소스·산출물 (private)

또한 PDF 렌더링과 시각 검증을 위해 macOS의 Chrome과 Quartz 환경이 필요합니다.

외부 의존성 처리

npx skills add는 이 저장소의 SKILL.md와 포함된 참조 파일·스크립트만 설치합니다. 위에 적은 제품 저장소, 디자인 시스템, 매뉴얼 저장소를 자동으로 clone하거나 인증하지 않습니다.

skill을 설치한 뒤 제품 저장소의 지침에 따라 필요한 private 저장소를 직접 clone하거나 최신 상태로 동기화하세요. 외부 저장소의 접근 권한이나 인증이 없으면 skill 자체는 설치되어도 제품 컨텍스트를 읽어야 하는 작업은 완료할 수 없습니다.

디렉터리 구조

dou-design-skills/
├── README.md
├── skills/
│   ├── dou-product-brief/
│   ├── dou-product-design/
│   ├── saylog-uxui-issues/
│   ├── saylog-ux-writing-korean/
│   └── saylog-manual-authoring/
└── docs/
    └── superpowers/
        ├── plans/
        └── specs/

각 skill은 skills//SKILL.md를 진입점으로 사용하며, 해당 디렉터리의 참조 문서·스크립트·asset은 skill과 함께 배포합니다.

기여

  1. skills//SKILL.md와 필요한 부속 파일을 수정하거나 새 skill 디렉터리를 추가합니다.
  2. README의 Skill 목록과 의존성 설명을 변경사항에 맞게 갱신합니다.
  3. git diff --check와 skill 설치 테스트를 실행합니다.
  4. private 제품 저장소의 비밀값·토큰·개인정보를 skill 파일이나 문서에 커밋하지 않습니다.

라이선스

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages