leerness 1.2.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,29 @@
1
+ # AX Migration Guide for AI Agents
2
+
3
+ 구버전 하네스, 자체 AGENTS/CLAUDE 지침, 오래된 `.harness/` 파일을 Leerness 최신 구조로 옮기기 위한 AI 전용 가이드입니다.
4
+
5
+ ## 목표
6
+
7
+ 기존 지식을 잃지 않고, 새 구조에서 AI가 어떤 파일을 읽고 어떤 파일을 갱신해야 하는지 명확하게 만듭니다.
8
+
9
+ ## 절차
10
+
11
+ 1. `leerness migrate --dry-run`으로 감지 목록을 확인합니다.
12
+ 2. 기존 파일을 `.harness/archive/legacy-migration-*`에 백업합니다.
13
+ 3. legacy 내용을 새 목적지로 분류합니다.
14
+ 4. `context-routing.md`, `writeback-policy.md`, `task-type-map.md`를 생성합니다.
15
+ 5. `AGENTS.md`가 새 라우팅 파일들을 보도록 갱신합니다.
16
+ 6. 민감정보 값은 제거하고 변수명만 남깁니다.
17
+ 7. `leerness verify`를 실행합니다.
18
+ 8. `session-handoff.md`에 마이그레이션 결과와 다음 작업을 기록합니다.
19
+
20
+ ## Legacy mapping
21
+
22
+ | Legacy content | New destination |
23
+ |---|---|
24
+ | 프로젝트 목적/방향 | project-brief.md |
25
+ | 현재 상태/작업 이력 | current-state.md, task-log.md |
26
+ | 구조/모듈/데이터 흐름 | architecture.md, context-map.md |
27
+ | 기존 AI 규칙 | AGENTS.md, guardrails.md, context-routing.md |
28
+ | 배포 이슈 | release-checklist.md |
29
+ | 성공한 반복 작업 | skill candidate 또는 .harness/skills/ |
@@ -0,0 +1,25 @@
1
+ # AX New Project Installation Guide for AI Agents
2
+
3
+ 진행 중인 프로젝트에 Leerness를 처음 적용할 때, AI가 프로젝트의 실제 내용을 하네스에 반영하기 위한 가이드입니다.
4
+
5
+ ## 목표
6
+
7
+ 템플릿을 그대로 두지 않고, 프로젝트 구조와 운영 방식이 반영된 하네스를 만듭니다.
8
+
9
+ ## 절차
10
+
11
+ 1. package.json, lockfile, framework config, routing, API, DB, deploy, test 파일을 확인합니다.
12
+ 2. project-brief.md에 목적, 사용자, 성공 기준을 작성합니다.
13
+ 3. architecture.md에 모듈, 경계, 데이터 흐름, 외부 서비스를 작성합니다.
14
+ 4. context-map.md에 실제 파일 경로를 기록합니다.
15
+ 5. design-system.md에 기존 UI 패턴을 기록합니다.
16
+ 6. feature-contracts.md에 주요 기능의 입력/출력/상태/오류를 기록합니다.
17
+ 7. release-checklist.md에 실제 배포/npm/git/CI/env 조건을 기록합니다.
18
+ 8. testing-strategy.md에 실제 검증 방법을 기록합니다.
19
+ 9. current-state.md와 session-handoff.md에 다음 정확한 작업을 기록합니다.
20
+
21
+ ## 금지
22
+
23
+ - 확인하지 않은 구조를 추측해서 쓰지 않습니다.
24
+ - 실제 토큰, 쿠키, 비밀번호를 기록하지 않습니다.
25
+ - 모르는 항목은 `Unknown` 또는 `Needs confirmation`으로 표시합니다.
@@ -1,58 +1,29 @@
1
- # Leerness AX Skill Library Guide
1
+ # AX Skill Library Guide
2
2
 
3
- AX는 AI eXperience입니다. 이 문서는 AI 에이전트가 검증된 스킬 데이터를 안전하게 학습, 검증, 빌드, 업로드, 업데이트, 병합, 마이그레이션하도록 안내합니다.
3
+ AI 검증된 스킬을 학습, 라이브러리화, 병합, 마이그레이션, 업로드할 따르는 기준입니다.
4
4
 
5
- ## 스킬 표시 기준
5
+ ## 기본 원칙
6
6
 
7
- `leerness skill list`는 아래 정보를 표시합니다.
7
+ - 스킬에는 실제 민감정보를 저장하지 않습니다.
8
+ - 환경변수 이름, secret manager key 이름, redacted 예시만 허용합니다.
9
+ - 스킬은 `displayNameKo`, `capabilities`, `lastUpdated`, `lastUpdatedAt`, `verification` 메타데이터를 가져야 합니다.
10
+ - `library publish`는 기본 dry-run이며, 실제 업로드는 `--execute`가 필요합니다.
11
+ - AI 검증 메타데이터가 없는 스킬은 업로드하지 않습니다.
8
12
 
9
- - 스킬 영문 id
10
- - 한글명 `displayNameKo`
11
- - 가능한 작업 `capabilities`
12
- - 최종 업데이트일 `lastUpdated`
13
- - AI 검증 상태 `verification.status`
14
- - 필요한 환경변수 이름 `requiresEnv`
15
-
16
- ## AI 검증 업로드 표준 흐름
17
-
18
- 1. 성공한 구현 패턴을 스킬 후보로 추출합니다.
19
- 2. `leerness skill learn <name> --from <path>`로 라이브러리 구조를 만듭니다.
20
- 3. `skill-library.json`에 한글명, 가능한 작업, 최종 업데이트일을 기록합니다.
21
- 4. 실제 토큰/쿠키/비밀번호/고객 데이터가 없는지 검사합니다.
22
- 5. `leerness library verify <path> --ai --reviewer leerness-ai`로 AI 검증 메타데이터를 기록합니다.
23
- 6. `leerness library validate <path> --strict-ai`로 업로드 게이트를 통과합니다.
24
- 7. `leerness library build <path>`로 배포 구조를 만듭니다.
25
- 8. `leerness library publish <built-path> --target npm|git`으로 dry-run을 확인합니다.
26
- 9. 사용자가 승인한 경우에만 `--execute`로 실제 업로드합니다.
27
-
28
- ## 설치 가능한 운영 스킬
13
+ ## 표준 흐름
29
14
 
30
15
  ```bash
31
- leerness skill add ai-verified-skill-publisher
16
+ leerness skill learn my-skill --from ./validated-workflow
17
+ leerness library verify ./my-skill --ai --reviewer leerness-ai
18
+ leerness library validate ./my-skill --strict-ai
19
+ leerness library build ./my-skill
20
+ leerness library publish ./my-skill/dist/my-skill --target npm
21
+ leerness library publish ./my-skill/dist/my-skill --target npm --execute
32
22
  ```
33
23
 
34
- 스킬은 AI가 검증된 스킬을 업로드·업데이트·병합·마이그레이션할 때 따라야 할 절차를 프로젝트에 설치합니다.
35
-
36
- ## 업로드 인증 토큰 규칙
37
-
38
- 검증된 스킬팩을 실제 업로드할 때는 아래 순서로 access token을 확인합니다.
39
-
40
- 1. `--token-env <ENV_NAME>`으로 지정한 환경변수
41
- 2. npm: `LEERNESS_NPM_TOKEN`, `NPM_TOKEN`, `NODE_AUTH_TOKEN`
42
- 3. Git/GitHub: `LEERNESS_GIT_TOKEN`, `LEERNESS_GITHUB_TOKEN`, `GITHUB_TOKEN`, `GH_TOKEN`
43
- 4. `.harness/skill-publish.local.json`의 `publishAuth.npmTokenEnv`, `publishAuth.gitTokenEnv`, `publishAuth.gitRemoteUrl`
44
- 5. 위 값이 없으면 AI/사용자에게 토큰 입력을 요구
45
-
46
- 권장 로컬 설정:
47
-
48
- ```json
49
- {
50
- "publishAuth": {
51
- "npmTokenEnv": "LEERNESS_NPM_TOKEN",
52
- "gitTokenEnv": "LEERNESS_GITHUB_TOKEN",
53
- "gitRemoteUrl": "https://github.com/gugu9999gu/leerness"
54
- }
55
- }
56
- ```
24
+ ## 업데이트
57
25
 
58
- 실제 토큰값은 저장하지 말고 환경변수나 Secret Manager둡니다.
26
+ - 변경 이유를 README 또는 changelog남깁니다.
27
+ - `lastUpdated`와 `lastUpdatedAt`을 갱신합니다.
28
+ - AI 검증을 다시 수행합니다.
29
+ - 민감정보 스캔을 통과해야 합니다.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "leerness",
3
- "version": "1.2.0",
4
- "description": "Leerness: 검증된 스킬팩의 npm/git 업로드 토큰 게이트, 한글 스킬 라이브러리 표시, AI 검증 업로드 스킬을 지원하는 AX 최적화 개발 하네스.",
3
+ "version": "1.3.1",
4
+ "description": "Leerness: Context Routing, Writeback Policy, AX 마이그레이션/신규설치 가이드로 AI가 적재적소의 프로젝트 메모리를 읽고 갱신하게 하는 AX 최적화 개발 하네스.",
5
5
  "keywords": [
6
6
  "leerness",
7
7
  "ai",
@@ -17,7 +17,13 @@
17
17
  "korean-skill-library",
18
18
  "ai-skill-publisher",
19
19
  "verified-skill-upload",
20
- "skill-capabilities"
20
+ "skill-capabilities",
21
+ "context-routing",
22
+ "writeback-policy",
23
+ "task-type-map",
24
+ "ai-migration-guide",
25
+ "new-project-guide",
26
+ "project-memory-router"
21
27
  ],
22
28
  "bin": {
23
29
  "leerness": "./bin/harness.js"
@@ -31,7 +37,7 @@
31
37
  "LICENSE"
32
38
  ],
33
39
  "scripts": {
34
- "test": "node ./bin/harness.js --help && node ./bin/harness.js init --yes --skills office,commerce-api,ai-verified-skill-publisher ./tmp-harness-test && node ./bin/harness.js status ./tmp-harness-test && node ./bin/harness.js skill list && node ./bin/harness.js skill info ai-verified-skill-publisher && node ./bin/harness.js library guide ./tmp-harness-test && node ./bin/harness.js verify ./tmp-harness-test",
40
+ "test": "node ./bin/harness.js --help && node ./bin/harness.js route release && node ./bin/harness.js init --yes --skills office,commerce-api,ai-verified-skill-publisher ./tmp-harness-test && node ./bin/harness.js status ./tmp-harness-test && node ./bin/harness.js skill list && node ./bin/harness.js skill info ai-verified-skill-publisher && node ./bin/harness.js library guide ./tmp-harness-test && node ./bin/harness.js verify ./tmp-harness-test",
35
41
  "prepack": "node ./bin/harness.js --version"
36
42
  },
37
43
  "repository": {
@@ -0,0 +1,24 @@
1
+ # 광고/GA4 분석 스킬 라이브러리
2
+
3
+ 영문명: Ads and GA4 Analytics Skill Library
4
+
5
+ ## 설명
6
+
7
+ GA4, 광고 전환, ROAS, UTM, 이벤트 추적 점검을 위한 스킬입니다.
8
+
9
+ ## 가능한 작업
10
+
11
+ - GA4 이벤트/전환 점검
12
+ - 광고 매체별 ROAS 해석
13
+ - UTM/세션 소스 문제 분석
14
+ - 전환 매출 차이 원인 정리
15
+
16
+ ## 민감정보 규칙
17
+
18
+ - 실제 토큰, 비밀번호, 쿠키, private key를 기록하지 않습니다.
19
+ - 필요한 값은 환경변수 이름만 기록합니다.
20
+ - 작업 후 current-state.md, task-log.md, session-handoff.md를 갱신합니다.
21
+
22
+ ## 최종 업데이트
23
+
24
+ 2026-04-29
@@ -1,39 +1,28 @@
1
1
  {
2
2
  "name": "ads-analytics",
3
- "version": "1.0.0",
4
- "title": "Ads and Analytics Skill Library",
5
- "category": "marketing",
6
- "description": "GA4, 광고 전환, ROAS, attribution 점검을 위한 스킬입니다.",
7
- "compatibleHarness": ">=1.1.0",
8
- "sensitiveDataPolicy": "env-reference-only",
9
- "requiresEnv": [
10
- "GA4_PROPERTY_ID"
3
+ "version": "1.3.0",
4
+ "title": "Ads and GA4 Analytics Skill Library",
5
+ "displayNameKo": "광고/GA4 분석 스킬 라이브러리",
6
+ "category": "analytics",
7
+ "categoryKo": "광고/분석",
8
+ "description": "GA4, 광고 전환, ROAS, UTM, 이벤트 추적 점검을 위한 스킬입니다.",
9
+ "capabilities": [
10
+ "GA4 이벤트/전환 점검",
11
+ "광고 매체별 ROAS 해석",
12
+ "UTM/세션 소스 문제 분석",
13
+ "전환 매출 차이 원인 정리"
11
14
  ],
15
+ "requiresEnv": [],
12
16
  "files": [
13
- "skills/ga4-debugging.md",
14
- "skills/conversion-attribution.md",
15
- "skills/roas-check.md"
17
+ "README.md"
16
18
  ],
17
- "lastUpdated": "2026-04-28",
18
- "lastUpdatedAt": "2026-04-28T00:00:00.000Z",
19
+ "source": "bundled",
20
+ "lastUpdated": "2026-04-29",
21
+ "lastUpdatedAt": "2026-04-29T00:00:00.000Z",
19
22
  "verification": {
20
23
  "status": "passed",
21
- "method": "bundled-ai-review",
24
+ "method": "ai-assisted-review",
22
25
  "verifiedBy": "leerness-ai",
23
- "verifiedAt": "2026-04-28T00:00:00.000Z",
24
- "checks": [
25
- "structure",
26
- "secret-scan",
27
- "env-reference-only",
28
- "reusability"
29
- ]
30
- },
31
- "displayNameKo": "광고·GA4 분석 스킬 라이브러리",
32
- "categoryKo": "마케팅/분석",
33
- "capabilities": [
34
- "GA4 이벤트·전환 디버깅",
35
- "광고 ROAS/전환매출 차이 원인 분석",
36
- "어트리뷰션/세션 소스 점검",
37
- "광고 리포트 해석 체크리스트"
38
- ]
26
+ "verifiedAt": "2026-04-29T00:00:00.000Z"
27
+ }
39
28
  }
@@ -1,24 +1,24 @@
1
- # AI 검증 스킬 업로드·라이브러리화 스킬
1
+ # AI 검증 스킬 업로드 스킬 라이브러리
2
2
 
3
- AI 에이전트가 검증된 스킬 데이터를 안전하게 라이브러리화하고 npm 또는 git으로 업로드할 때 사용하는 운영 절차입니다.
3
+ 영문명: AI Verified Skill Publisher Skill Library
4
+
5
+ ## 설명
6
+
7
+ 검증된 스킬을 라이브러리화하고 npm/git에 안전하게 업로드하기 위한 스킬입니다.
4
8
 
5
9
  ## 가능한 작업
6
10
 
7
- - 성공한 구현 패턴을 스킬 후보로 추출
8
- - 스킬 메타데이터에 한글명, 가능한 작업, 최종 업데이트일, 검증 상태 기록
9
- - 민감정보를 제거하고 환경변수 이름만 남김
10
- - AI 검증 메타데이터를 생성하고 strict-ai 검증 통과
11
- - npm/git access token을 환경변수 또는 로컬 설정에서 확인
12
- - 토큰이 없으면 실제 업로드 직전에 입력 요구
13
- - npm/git 업로드 전 dry-run 확인
14
- - 업데이트, 병합, 마이그레이션 후 재검증
11
+ - 검증된 작업 흐름을 스킬 후보로 정규화
12
+ - 민감정보 스캔 업로드 차단
13
+ - AI 검증 메타데이터 기록
14
+ - npm/git dry-run --execute 배포
15
+
16
+ ## 민감정보 규칙
15
17
 
16
- ## 인증 우선순위
18
+ - 실제 토큰, 비밀번호, 쿠키, private key를 기록하지 않습니다.
19
+ - 필요한 값은 환경변수 이름만 기록합니다.
20
+ - 작업 후 current-state.md, task-log.md, session-handoff.md를 갱신합니다.
17
21
 
18
- 1. `--token-env <ENV_NAME>`
19
- 2. `LEERNESS_NPM_TOKEN`, `NPM_TOKEN`, `NODE_AUTH_TOKEN`
20
- 3. `LEERNESS_GIT_TOKEN`, `LEERNESS_GITHUB_TOKEN`, `GITHUB_TOKEN`, `GH_TOKEN`
21
- 4. `.harness/skill-publish.local.json`
22
- 5. 없으면 프롬프트 입력
22
+ ## 최종 업데이트
23
23
 
24
- Git 기본 저장소 경로는 `https://github.com/gugu9999gu/leerness`입니다.
24
+ 2026-04-29
@@ -1,56 +1,31 @@
1
1
  {
2
2
  "name": "ai-verified-skill-publisher",
3
- "version": "1.1.0",
3
+ "version": "1.3.0",
4
4
  "title": "AI Verified Skill Publisher Skill Library",
5
- "displayNameKo": "AI 검증 스킬 업로드·라이브러리화 스킬",
6
- "category": "skill-operations",
7
- "categoryKo": "스킬 운영/배포",
8
- "description": "AI가 검증된 스킬 데이터를 표준 포맷으로 정리하고, 민감정보를 제거한 뒤 npm/git 라이브러리로 업로드·업데이트·병합·마이그레이션할 따르는 운영 스킬입니다.",
9
- "compatibleHarness": ">=1.2.0",
10
- "sensitiveDataPolicy": "env-reference-only",
5
+ "displayNameKo": "AI 검증 스킬 업로드 스킬 라이브러리",
6
+ "category": "skill-library",
7
+ "categoryKo": "스킬 라이브러리/배포",
8
+ "description": "검증된 스킬을 라이브러리화하고 npm/git 안전하게 업로드하기 위한 스킬입니다.",
9
+ "capabilities": [
10
+ "검증된 작업 흐름을 스킬 후보로 정규화",
11
+ "민감정보 스캔 후 업로드 차단",
12
+ "AI 검증 메타데이터 기록",
13
+ "npm/git dry-run 후 --execute 배포"
14
+ ],
11
15
  "requiresEnv": [
12
16
  "LEERNESS_NPM_TOKEN",
13
- "NPM_TOKEN",
14
- "NODE_AUTH_TOKEN",
15
- "LEERNESS_GIT_TOKEN",
16
- "LEERNESS_GITHUB_TOKEN",
17
- "GITHUB_TOKEN",
18
- "GH_TOKEN",
19
- "GIT_REMOTE_URL"
20
- ],
21
- "capabilities": [
22
- "검증된 구현 패턴을 스킬 후보로 추출",
23
- "스킬 메타데이터에 한글명·가능 작업·최종 업데이트일 기록",
24
- "민감정보 스캔 후 환경변수 이름만 남기기",
25
- "AI 검증 메타데이터 생성 및 strict-ai 검증",
26
- "npm/git 업로드 dry-run과 --execute 승인 흐름 수행",
27
- "기존 스킬 라이브러리 업데이트·병합·마이그레이션 절차화",
28
- "npm/git access token 존재 여부 확인 후 없으면 업로드 직전 입력 요구",
29
- "프로젝트 로컬 설정 .harness/skill-publish.local.json 기준으로 배포 인증 소스 연결",
30
- "Git 기본 저장소 경로 https://github.com/gugu9999gu/leerness 기준 업로드 흐름 안내"
17
+ "LEERNESS_GITHUB_TOKEN"
31
18
  ],
32
19
  "files": [
33
- "README.md",
34
- "skills/ai-verified-skill-upload.md",
35
- "skills/skill-metadata-standard.md",
36
- "skills/skill-library-release-flow.md",
37
- "skills/publish-auth-token-gate.md"
20
+ "README.md"
38
21
  ],
39
- "lastUpdated": "2026-04-28",
40
- "lastUpdatedAt": "2026-04-28T00:00:00.000Z",
22
+ "source": "bundled",
23
+ "lastUpdated": "2026-04-29",
24
+ "lastUpdatedAt": "2026-04-29T00:00:00.000Z",
41
25
  "verification": {
42
26
  "status": "passed",
43
- "method": "bundled-ai-review",
27
+ "method": "ai-assisted-review",
44
28
  "verifiedBy": "leerness-ai",
45
- "verifiedAt": "2026-04-28T00:00:00.000Z",
46
- "checks": [
47
- "structure",
48
- "secret-scan",
49
- "env-reference-only",
50
- "ai-publish-gate",
51
- "metadata-display",
52
- "publish-auth-token-gate",
53
- "git-repository-url"
54
- ]
29
+ "verifiedAt": "2026-04-29T00:00:00.000Z"
55
30
  }
56
31
  }
@@ -0,0 +1,24 @@
1
+ # 앱스토어 심사 대응 스킬 라이브러리
2
+
3
+ 영문명: App Store Review Response Skill Library
4
+
5
+ ## 설명
6
+
7
+ App Store 심사 리젝, 개인정보 라벨, 웹뷰 앱 대응을 위한 스킬입니다.
8
+
9
+ ## 가능한 작업
10
+
11
+ - 심사 메시지 원인 분류
12
+ - 개인정보 라벨 수정 가이드
13
+ - 웹 기반 앱 데이터 수집 범위 정리
14
+ - 심사 답변 초안 작성
15
+
16
+ ## 민감정보 규칙
17
+
18
+ - 실제 토큰, 비밀번호, 쿠키, private key를 기록하지 않습니다.
19
+ - 필요한 값은 환경변수 이름만 기록합니다.
20
+ - 작업 후 current-state.md, task-log.md, session-handoff.md를 갱신합니다.
21
+
22
+ ## 최종 업데이트
23
+
24
+ 2026-04-29
@@ -1,37 +1,28 @@
1
1
  {
2
2
  "name": "appstore-review",
3
- "version": "1.0.0",
4
- "title": "App Store Review Skill Library",
3
+ "version": "1.3.0",
4
+ "title": "App Store Review Response Skill Library",
5
+ "displayNameKo": "앱스토어 심사 대응 스킬 라이브러리",
5
6
  "category": "mobile",
6
- "description": "App Store 심사 대응, 개인정보 라벨, 웹뷰 앱 검토를 위한 스킬입니다.",
7
- "compatibleHarness": ">=1.1.0",
8
- "sensitiveDataPolicy": "env-reference-only",
7
+ "categoryKo": "앱스토어/모바일",
8
+ "description": "App Store 심사 리젝, 개인정보 라벨, 웹뷰 앱 대응을 위한 스킬입니다.",
9
+ "capabilities": [
10
+ "심사 메시지 원인 분류",
11
+ "개인정보 라벨 수정 가이드",
12
+ "웹 기반 앱 데이터 수집 범위 정리",
13
+ "심사 답변 초안 작성"
14
+ ],
9
15
  "requiresEnv": [],
10
16
  "files": [
11
- "skills/privacy-labels.md",
12
- "skills/review-response.md",
13
- "skills/webview-app.md"
17
+ "README.md"
14
18
  ],
15
- "lastUpdated": "2026-04-28",
16
- "lastUpdatedAt": "2026-04-28T00:00:00.000Z",
19
+ "source": "bundled",
20
+ "lastUpdated": "2026-04-29",
21
+ "lastUpdatedAt": "2026-04-29T00:00:00.000Z",
17
22
  "verification": {
18
23
  "status": "passed",
19
- "method": "bundled-ai-review",
24
+ "method": "ai-assisted-review",
20
25
  "verifiedBy": "leerness-ai",
21
- "verifiedAt": "2026-04-28T00:00:00.000Z",
22
- "checks": [
23
- "structure",
24
- "secret-scan",
25
- "env-reference-only",
26
- "reusability"
27
- ]
28
- },
29
- "displayNameKo": "앱스토어 심사 대응 스킬 라이브러리",
30
- "categoryKo": "모바일/심사",
31
- "capabilities": [
32
- "App Store 심사 답변 초안 작성",
33
- "개인정보 라벨·수집 목적 점검",
34
- "웹뷰 앱 심사 이슈 대응",
35
- "버그픽스 제출/리젝 사유 정리"
36
- ]
26
+ "verifiedAt": "2026-04-29T00:00:00.000Z"
27
+ }
37
28
  }
@@ -0,0 +1,24 @@
1
+ # 커머스 API 연동 스킬 라이브러리
2
+
3
+ 영문명: Commerce API Integration Skill Library
4
+
5
+ ## 설명
6
+
7
+ 쿠팡·롯데온·스마트스토어 등 커머스 API 연동 패턴을 위한 스킬입니다.
8
+
9
+ ## 가능한 작업
10
+
11
+ - API 인증 구조 설계
12
+ - 상품/주문/매출 동기화 플로우 구현
13
+ - 환경변수 기반 민감정보 분리
14
+ - 오류·재시도·레이트리밋 대응
15
+
16
+ ## 민감정보 규칙
17
+
18
+ - 실제 토큰, 비밀번호, 쿠키, private key를 기록하지 않습니다.
19
+ - 필요한 값은 환경변수 이름만 기록합니다.
20
+ - 작업 후 current-state.md, task-log.md, session-handoff.md를 갱신합니다.
21
+
22
+ ## 최종 업데이트
23
+
24
+ 2026-04-29
@@ -1,48 +1,32 @@
1
1
  {
2
2
  "name": "commerce-api",
3
- "version": "1.0.0",
3
+ "version": "1.3.0",
4
4
  "title": "Commerce API Integration Skill Library",
5
- "category": "commerce",
6
- "description": "쿠팡, 롯데온, 스마트스토어 등 커머스 API 연동 패턴과 보안 규칙을 담은 스킬 모음입니다.",
7
- "compatibleHarness": ">=1.1.0",
8
- "sensitiveDataPolicy": "env-reference-only",
5
+ "displayNameKo": "커머스 API 연동 스킬 라이브러리",
6
+ "category": "commerce-api",
7
+ "categoryKo": "커머스/API 연동",
8
+ "description": "쿠팡·롯데온·스마트스토어 등 커머스 API 연동 패턴을 위한 스킬입니다.",
9
+ "capabilities": [
10
+ "API 인증 구조 설계",
11
+ "상품/주문/매출 동기화 플로우 구현",
12
+ "환경변수 기반 민감정보 분리",
13
+ "오류·재시도·레이트리밋 대응"
14
+ ],
9
15
  "requiresEnv": [
10
- "COMMERCE_API_BASE_URL",
11
- "COUPANG_ACCESS_KEY",
12
- "COUPANG_SECRET_KEY",
13
- "COUPANG_VENDOR_ID",
14
- "LOTTEON_CLIENT_ID",
15
- "LOTTEON_CLIENT_SECRET",
16
- "SMARTSTORE_CLIENT_ID",
17
- "SMARTSTORE_CLIENT_SECRET"
16
+ "COMMERCE_CLIENT_ID",
17
+ "COMMERCE_CLIENT_SECRET",
18
+ "COMMERCE_VENDOR_ID"
18
19
  ],
19
20
  "files": [
20
- "skills/common-auth.md",
21
- "skills/coupang.md",
22
- "skills/lotteon.md",
23
- "skills/smartstore.md",
24
- "skills/order-sync.md"
21
+ "README.md"
25
22
  ],
26
- "lastUpdated": "2026-04-28",
27
- "lastUpdatedAt": "2026-04-28T00:00:00.000Z",
23
+ "source": "bundled",
24
+ "lastUpdated": "2026-04-29",
25
+ "lastUpdatedAt": "2026-04-29T00:00:00.000Z",
28
26
  "verification": {
29
27
  "status": "passed",
30
- "method": "bundled-ai-review",
28
+ "method": "ai-assisted-review",
31
29
  "verifiedBy": "leerness-ai",
32
- "verifiedAt": "2026-04-28T00:00:00.000Z",
33
- "checks": [
34
- "structure",
35
- "secret-scan",
36
- "env-reference-only",
37
- "reusability"
38
- ]
39
- },
40
- "displayNameKo": "커머스 API 연동 스킬 라이브러리",
41
- "categoryKo": "커머스/외부 API",
42
- "capabilities": [
43
- "쿠팡·롯데온·스마트스토어 API 인증 구조 설계",
44
- "주문/상품/매출 동기화 플로우 구현",
45
- "환경변수 기반 민감정보 분리",
46
- "API 오류·재시도·레이트리밋 대응"
47
- ]
30
+ "verifiedAt": "2026-04-29T00:00:00.000Z"
31
+ }
48
32
  }
@@ -0,0 +1,24 @@
1
+ # 크롤링/브라우저 자동화 스킬 라이브러리
2
+
3
+ 영문명: Crawling and Browser Automation Skill Library
4
+
5
+ ## 설명
6
+
7
+ API가 없거나 제한된 관리자 화면 자동화 작업을 위한 스킬입니다.
8
+
9
+ ## 가능한 작업
10
+
11
+ - Playwright 기반 다운로드 자동화
12
+ - 로그인 세션 storageState 관리
13
+ - 다운로드 파일 검증
14
+ - 실패 시 스크린샷/로그 수집
15
+
16
+ ## 민감정보 규칙
17
+
18
+ - 실제 토큰, 비밀번호, 쿠키, private key를 기록하지 않습니다.
19
+ - 필요한 값은 환경변수 이름만 기록합니다.
20
+ - 작업 후 current-state.md, task-log.md, session-handoff.md를 갱신합니다.
21
+
22
+ ## 최종 업데이트
23
+
24
+ 2026-04-29
@@ -1,40 +1,28 @@
1
1
  {
2
2
  "name": "crawling",
3
- "version": "1.0.0",
3
+ "version": "1.3.0",
4
4
  "title": "Crawling and Browser Automation Skill Library",
5
+ "displayNameKo": "크롤링/브라우저 자동화 스킬 라이브러리",
5
6
  "category": "automation",
6
- "description": "API가 없거나 제한적일 때 브라우저 자동화와 다운로드 자동화를 안전하게 구현하기 위한 스킬입니다.",
7
- "compatibleHarness": ">=1.1.0",
8
- "sensitiveDataPolicy": "env-reference-only",
9
- "requiresEnv": [
10
- "CRAWLER_USER_ID",
11
- "CRAWLER_PASSWORD"
7
+ "categoryKo": "크롤링/자동화",
8
+ "description": "API가 없거나 제한된 관리자 화면 자동화 작업을 위한 스킬입니다.",
9
+ "capabilities": [
10
+ "Playwright 기반 다운로드 자동화",
11
+ "로그인 세션 storageState 관리",
12
+ "다운로드 파일 검증",
13
+ "실패 시 스크린샷/로그 수집"
12
14
  ],
15
+ "requiresEnv": [],
13
16
  "files": [
14
- "skills/browser-automation.md",
15
- "skills/download-automation.md",
16
- "skills/cloud-runtime.md"
17
+ "README.md"
17
18
  ],
18
- "lastUpdated": "2026-04-28",
19
- "lastUpdatedAt": "2026-04-28T00:00:00.000Z",
19
+ "source": "bundled",
20
+ "lastUpdated": "2026-04-29",
21
+ "lastUpdatedAt": "2026-04-29T00:00:00.000Z",
20
22
  "verification": {
21
23
  "status": "passed",
22
- "method": "bundled-ai-review",
24
+ "method": "ai-assisted-review",
23
25
  "verifiedBy": "leerness-ai",
24
- "verifiedAt": "2026-04-28T00:00:00.000Z",
25
- "checks": [
26
- "structure",
27
- "secret-scan",
28
- "env-reference-only",
29
- "reusability"
30
- ]
31
- },
32
- "displayNameKo": "크롤링·브라우저 자동화 스킬 라이브러리",
33
- "categoryKo": "자동화/수집",
34
- "capabilities": [
35
- "Playwright 기반 브라우저 자동화",
36
- "로그인 세션·다운로드 자동화 설계",
37
- "클라우드 서버 실행 제약 점검",
38
- "CAPTCHA/2FA/이용약관 리스크 분리"
39
- ]
26
+ "verifiedAt": "2026-04-29T00:00:00.000Z"
27
+ }
40
28
  }