ltcai 0.1.9 → 0.1.16

package/skills/SKILL_TEMPLATE.md

@@ -2,56 +2,88 @@
 
 ## 메타데이터
 - **버전**: 0.1.0
-- **카테고리**: [coding | data | document | web | system | analysis]
-- **위험도**: [low | medium | high]  <!-- low=읽기, medium=쓰기, high=실행/삭제 -->
-- **필요 권한**: [none | local_read | local_write | exec | admin]
+- **카테고리**: coding | data | document | web | system | analysis
+- **위험도**: low | medium | high
+- **필요 권한**: none | local_read | local_write | exec | network | admin
 
 ## 설명
+
 한 줄 설명.
 
+## 거버넌스
+
+`risk.json` 참고. 요약: `risk=read|write|exec|destructive`, `destructive=false`, `shell=false`, `network=false`, `auto_approve=true`, `sandbox=workspace|home|system`, `rollback=none|backup|git`
+
+## 트리거 조건
+
+호출해야 하는 상황:
+- (예) 사용자가 "이 파일 고쳐줘", "수정해줘"라고 말할 때
+- (예) 에이전트가 Implement 단계에서 코드 변경이 필요할 때
+
+호출하면 **안** 되는 상황:
+- (예) 파일 내용 확인만 필요할 때 → `read_file` 사용
+- (예) 디렉토리 목록 조회 → `list_dir` 사용
+
+## Side Effects
+
+| 항목 | 내용 |
+|------|------|
+| 파일 변경 | 없음 |
+| 생성 파일 | 없음 |
+| 프로세스 | 없음 |
+| 네트워크 | 없음 |
+
+## Rollback
+
+| 항목 | 내용 |
+|------|------|
+| 가능 여부 | none / git |
+| 방법 | (없음 / `git checkout <file>`) |
+| 주의사항 | git 미초기화 시 rollback 불가 |
+
 ## 입력 스키마
-```json
-{
-  "required": ["field1"],
-  "optional": ["field2"],
-  "properties": {
-    "field1": { "type": "string", "description": "..." },
-    "field2": { "type": "integer", "default": 10 }
-  }
-}
-```
+
+`schema.json` → `input` 블록 참고.
+
+| 필드 | 타입 | 필수 | 설명 |
+|------|------|------|------|
+| `field1` | string | ✅ | ... |
+| `field2` | integer | ❌ | 기본값: 10 |
 
 ## 출력 스키마
+
+`schema.json` → `output` 블록 참고.
+
+성공:
+```json
+{ "success": true, "result": { ... } }
+```
+실패:
 ```json
-{
-  "success": true,
-  "result": "...",
-  "artifacts": []
-}
+{ "success": false, "error": "ERROR_CODE", "message": "..." }
 ```
 
 ## 실행 조건
-- 사전 조건 (예: 모델 로드 필요, 파일 존재 여부)
-- 후처리 조건
 
-## 예제
+- 사전 조건 (예: 모델 로드 필요, 파일 존재 여부)
 
-### 성공 케이스
-**입력**: `{ "field1": "예시값" }`  
-**출력**: `{ "success": true, "result": "..." }`
+## 실패 처리
 
-### 실패 케이스
-**입력**: `{ "field1": "" }`  
-**출력**: `{ "success": false, "error": "field1 is required" }`
+`schema.json` → `evals` 블록 참고.
 
-## 실패 처리
 | 에러 코드 | 원인 | 처리 방법 |
 |-----------|------|-----------|
 | `INVALID_INPUT` | 필수 필드 누락 | 입력 검증 후 재시도 |
 | `PERMISSION_DENIED` | 권한 없음 | 관리자에게 문의 |
 | `TIMEOUT` | 실행 시간 초과 | 작업 분할 후 재시도 |
 
+## 예제
+
+`examples.md` 참고.
+
 ## 테스트 케이스
+
 ```python
-# tests/skills/test_<name>.py 참조
+# tests/unit/test_tools.py::test_<name>_*
+# tests/integration/test_api.py::test_agent_<name>_*
 ```

package/skills/code_review/SKILL.md

@@ -9,6 +9,34 @@
 ## 설명
 파일 또는 코드 스니펫을 LLM에 전달해 버그, 보안 이슈, 성능, 스타일을 리뷰한다.
 
+## 거버넌스
+
+`policies/policy.md` 참고. 요약: `risk=read`, `destructive=false`, `shell=false`, `network=false(local)/true(cloud)`, `auto_approve=true`, `sandbox=workspace`, `rollback=none`
+
+## 트리거 조건
+
+호출해야 하는 상황:
+- 사용자가 "이 코드 리뷰해줘", "보안 검토해줘", "버그 있어?"라고 요청할 때
+- 에이전트가 Verify 단계에서 작성한 코드를 검증해야 할 때
+- PR 제출 전 코드 품질 확인이 필요할 때
+
+호출하면 **안** 되는 상황:
+- 코드를 수정해야 할 때 → `edit_file` 사용
+- 파일 내용만 확인할 때 → `read_file` 사용
+
+## Side Effects
+
+| 항목 | 내용 |
+|------|------|
+| 파일 변경 | 없음 |
+| 생성 파일 | 없음 |
+| 프로세스 | 없음 |
+| 네트워크 | 클라우드 LLM 사용 시 코드 내용이 외부 API로 전송됨 |
+
+## Rollback
+
+없음. 읽기 전용 작업.
+
 ## 입력 스키마
 ```json
 {

package/skills/code_review/examples.md

@@ -0,0 +1,59 @@
+# code_review — Examples
+
+## 1. Security review of a snippet (success)
+
+**Input**
+```json
+{ "target": "def foo(x):\n  return eval(x)\n", "focus": ["security"] }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "summary": "1개의 심각한 보안 이슈 발견",
+    "issues": [{ "severity": "high", "line": 2, "category": "security", "message": "eval()에 사용자 입력이 직접 전달됨 — 임의 코드 실행 가능" }],
+    "score": 40
+  }
+}
+```
+
+## 2. File review (success)
+
+**Input**
+```json
+{ "target": "~/project/server.py", "focus": ["bug","performance"], "max_lines": 200 }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "summary": "전반적으로 양호. 1개의 중간 수준 버그 발견.",
+    "issues": [{ "severity": "medium", "line": 87, "category": "bug", "message": "race condition: shared dict에 lock 없이 동시 접근 가능" }],
+    "score": 75
+  }
+}
+```
+
+## 3. Empty target (failure)
+
+**Input**
+```json
+{ "target": "" }
+```
+**Output**
+```json
+{ "success": false, "error": "INVALID_INPUT", "message": "target is required" }
+```
+
+## 4. Model not loaded (failure)
+
+**Input**
+```json
+{ "target": "x = 1\n" }
+```
+**Output**
+```json
+{ "success": false, "error": "MODEL_NOT_LOADED", "message": "LLM이 로드되지 않았습니다. /model 명령으로 모델을 선택하세요." }
+```

package/skills/code_review/risk.json

@@ -0,0 +1,9 @@
+{
+  "risk": "read",
+  "destructive": false,
+  "shell": false,
+  "network": false,
+  "auto_approve": true,
+  "sandbox": "workspace",
+  "rollback": "none"
+}

package/skills/code_review/schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "code_review",
+  "input": {
+    "required": ["target"],
+    "optional": ["focus", "lang", "max_lines"],
+    "properties": {
+      "target":    { "type": "string", "description": "절대 파일 경로 또는 코드 스니펫 문자열" },
+      "focus":     { "type": "array", "items": { "type": "string", "enum": ["bug","security","performance","style"] }, "default": ["bug","security"] },
+      "lang":      { "type": "string", "description": "언어 힌트 (python, js, go …). 미입력시 자동 감지" },
+      "max_lines": { "type": "integer", "default": 500 }
+    }
+  },
+  "output": {
+    "oneOf": [
+      {
+        "title": "success",
+        "properties": {
+          "success": { "const": true },
+          "result": {
+            "properties": {
+              "summary": { "type": "string" },
+              "issues": {
+                "type": "array",
+                "items": {
+                  "properties": {
+                    "severity": { "type": "string", "enum": ["high","medium","low"] },
+                    "line":     { "type": "integer" },
+                    "category": { "type": "string" },
+                    "message":  { "type": "string" }
+                  },
+                  "required": ["severity","category","message"]
+                }
+              },
+              "score": { "type": "integer", "minimum": 0, "maximum": 100 }
+            },
+            "required": ["summary","issues","score"]
+          }
+        },
+        "required": ["success","result"]
+      },
+      {
+        "title": "failure",
+        "properties": {
+          "success": { "const": false },
+          "error":   { "type": "string", "enum": ["INVALID_INPUT","FILE_NOT_FOUND","MODEL_NOT_LOADED","SIZE_LIMIT"] },
+          "message": { "type": "string" }
+        },
+        "required": ["success","error","message"]
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": "snippet_review",
+      "input": { "target": "def foo(x):\n  return eval(x)\n", "focus": ["security"] },
+      "pass_criteria": "success == true and score < 80"
+    },
+    {
+      "id": "empty_target",
+      "input": { "target": "" },
+      "pass_criteria": "error == INVALID_INPUT"
+    }
+  ]
+}

package/skills/data_analysis/SKILL.md

@@ -9,6 +9,34 @@
 ## 설명
 CSV/Excel/JSON 파일을 읽어 기초 통계, 컬럼 요약, 이상치 탐지를 수행하고 인사이트를 제공한다.
 
+## 거버넌스
+
+`policies/policy.md` 참고. 요약: `risk=read`, `destructive=false`, `shell=false`, `network=false`, `auto_approve=true`, `sandbox=home`, `rollback=none`
+
+## 트리거 조건
+
+호출해야 하는 상황:
+- 사용자가 "이 CSV 분석해줘", "이 데이터 통계 내줘", "이상치 찾아줘"라고 요청할 때
+- 에이전트가 Discover 단계에서 데이터 파일의 구조를 파악해야 할 때
+- 상관관계, 추세, 분포를 파악해야 할 때
+
+호출하면 **안** 되는 상황:
+- 파일을 수정해야 할 때 → `edit_file` / `write_file` 사용
+- .csv가 아닌 텍스트 파일 내용 검색 → `grep` 사용
+
+## Side Effects
+
+| 항목 | 내용 |
+|------|------|
+| 파일 변경 | 없음 |
+| 생성 파일 | 없음 |
+| 프로세스 | 없음 |
+| 네트워크 | 없음 |
+
+## Rollback
+
+없음. 읽기 전용 작업.
+
 ## 입력 스키마
 ```json
 {

package/skills/data_analysis/examples.md

@@ -0,0 +1,62 @@
+# data_analysis — Examples
+
+## 1. CSV summary + outlier detection (success)
+
+**Input**
+```json
+{ "path": "~/data/sales.csv", "analysis_type": ["summary", "outlier"] }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "shape": [500, 4],
+    "columns": ["date", "revenue", "units", "region"],
+    "summary": { "revenue": { "mean": 15000.0, "std": 4200.0, "min": 200, "max": 89000 } },
+    "outliers": { "revenue": [89000] },
+    "insights": "revenue 컬럼에서 1개의 이상치(89000) 발견. 평균 대비 17.6 표준편차."
+  }
+}
+```
+
+## 2. Correlation analysis (success)
+
+**Input**
+```json
+{ "path": "~/data/metrics.csv", "columns": ["cpu", "latency"], "analysis_type": ["correlation"] }
+```
+**Output**
+```json
+{
+  "success": true,
+  "result": {
+    "shape": [1000, 2],
+    "columns": ["cpu", "latency"],
+    "summary": { "cpu": { "mean": 45.2 }, "latency": { "mean": 120.5 } },
+    "insights": "cpu와 latency 간 강한 양의 상관관계 (r=0.87) 확인."
+  }
+}
+```
+
+## 3. Unsupported format (failure)
+
+**Input**
+```json
+{ "path": "~/data/photo.png" }
+```
+**Output**
+```json
+{ "success": false, "error": "UNSUPPORTED_FORMAT", "message": "Supported formats: csv, xlsx, json" }
+```
+
+## 4. File not found (failure)
+
+**Input**
+```json
+{ "path": "~/data/missing.csv" }
+```
+**Output**
+```json
+{ "success": false, "error": "FILE_NOT_FOUND", "message": "No such file: /home/user/data/missing.csv" }
+```

package/skills/data_analysis/risk.json

@@ -0,0 +1,9 @@
+{
+  "risk": "read",
+  "destructive": false,
+  "shell": false,
+  "network": false,
+  "auto_approve": true,
+  "sandbox": "home",
+  "rollback": "none"
+}

package/skills/data_analysis/schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "data_analysis",
+  "input": {
+    "required": ["path"],
+    "optional": ["columns", "analysis_type", "max_rows"],
+    "properties": {
+      "path":          { "type": "string", "description": "분석할 파일 절대 경로 (.csv, .xlsx, .json)" },
+      "columns":       { "type": "array", "items": { "type": "string" }, "description": "분석할 컬럼 목록. 미입력시 전체" },
+      "analysis_type": { "type": "array", "items": { "type": "string", "enum": ["summary","outlier","correlation","trend"] }, "default": ["summary"] },
+      "max_rows":      { "type": "integer", "default": 10000 }
+    }
+  },
+  "output": {
+    "oneOf": [
+      {
+        "title": "success",
+        "properties": {
+          "success": { "const": true },
+          "result": {
+            "properties": {
+              "shape":    { "type": "array", "items": { "type": "integer" }, "minItems": 2, "maxItems": 2 },
+              "columns":  { "type": "array", "items": { "type": "string" } },
+              "summary":  { "type": "object" },
+              "outliers": { "type": "object" },
+              "insights": { "type": "string" }
+            },
+            "required": ["shape","columns","summary"]
+          }
+        },
+        "required": ["success","result"]
+      },
+      {
+        "title": "failure",
+        "properties": {
+          "success": { "const": false },
+          "error":   { "type": "string", "enum": ["INVALID_INPUT","FILE_NOT_FOUND","UNSUPPORTED_FORMAT","PARSE_ERROR","SIZE_LIMIT"] },
+          "message": { "type": "string" }
+        },
+        "required": ["success","error","message"]
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": "csv_summary",
+      "input": { "path": "__TEST__/sales.csv", "analysis_type": ["summary"] },
+      "pass_criteria": "success == true and shape[0] > 0"
+    },
+    {
+      "id": "unsupported_format",
+      "input": { "path": "__TEST__/photo.png" },
+      "pass_criteria": "error == UNSUPPORTED_FORMAT"
+    },
+    {
+      "id": "missing_path",
+      "input": {},
+      "pass_criteria": "error == INVALID_INPUT"
+    }
+  ]
+}

package/skills/file_edit/SKILL.md

@@ -9,6 +9,39 @@
 ## 설명
 로컬 파일을 읽고 특정 범위를 편집한 뒤 저장한다. 원본 백업을 `.bak` 파일로 생성한다.
 
+## 거버넌스
+
+`policies/policy.md` 참고. 요약: `risk=write`, `destructive=false`, `shell=false`, `network=false`, `auto_approve=false`, `sandbox=workspace`, `rollback=git`
+
+## 트리거 조건
+
+호출해야 하는 상황:
+- 에이전트가 Implement 단계에서 코드/설정 파일을 변경해야 할 때
+- 사용자가 "이 부분 고쳐줘", "이 라인 바꿔줘", "수정해줘"라고 요청할 때
+- `read_file`로 내용 확인 후 특정 문자열을 교체해야 할 때
+
+호출하면 **안** 되는 상황:
+- 파일 내용 확인만 필요할 때 → `read_file` 사용
+- 파일 전체를 처음부터 새로 쓸 때 → `write_file` 사용
+- 바이너리 파일(이미지, ZIP 등) 수정 시도 → 불가, `BINARY_FILE` 에러
+
+## Side Effects
+
+| 항목 | 내용 |
+|------|------|
+| 파일 변경 | 대상 파일의 내용이 영구 변경됨 |
+| 생성 파일 | 없음 (`backup=false` 기본) |
+| 프로세스 | 없음 |
+| 네트워크 | 없음 |
+
+## Rollback
+
+| 항목 | 내용 |
+|------|------|
+| 가능 여부 | `git` — git이 초기화된 워크스페이스에서 복구 가능 |
+| 방법 | `git diff <file>` 확인 후 `git checkout <file>` |
+| 주의사항 | git 미초기화 시 rollback 불가 (`.bak` 파일 없음, backup=false 기본) |
+
 ## 입력 스키마
 ```json
 {

package/skills/file_edit/examples.md

@@ -0,0 +1,45 @@
+# file_edit — Examples
+
+## 1. Single-line replacement (success)
+
+**Input**
+```json
+{ "path": "~/project/config.py", "new_content": "DEBUG = False\n", "start_line": 5, "end_line": 5 }
+```
+**Output**
+```json
+{ "success": true, "result": { "path": "/home/user/project/config.py", "lines_changed": 1, "backup_path": null } }
+```
+
+## 2. Full file replacement (success)
+
+**Input**
+```json
+{ "path": "~/project/hello.py", "new_content": "print('hello')\n" }
+```
+**Output**
+```json
+{ "success": true, "result": { "path": "/home/user/project/hello.py", "lines_changed": 1, "backup_path": null } }
+```
+
+## 3. Binary file rejected (failure)
+
+**Input**
+```json
+{ "path": "~/photo.png", "new_content": "..." }
+```
+**Output**
+```json
+{ "success": false, "error": "BINARY_FILE", "message": "Binary files cannot be edited as text" }
+```
+
+## 4. File not found (failure)
+
+**Input**
+```json
+{ "path": "~/nonexistent.py", "new_content": "x = 1\n", "start_line": 1 }
+```
+**Output**
+```json
+{ "success": false, "error": "FILE_NOT_FOUND", "message": "No such file: /home/user/nonexistent.py" }
+```

package/skills/file_edit/risk.json

@@ -0,0 +1,9 @@
+{
+  "risk": "write",
+  "destructive": false,
+  "shell": false,
+  "network": false,
+  "auto_approve": false,
+  "sandbox": "workspace",
+  "rollback": "git"
+}

package/skills/file_edit/schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "file_edit",
+  "input": {
+    "required": ["path", "new_content"],
+    "optional": ["start_line", "end_line", "backup"],
+    "properties": {
+      "path":        { "type": "string",  "description": "절대 경로 또는 ~/로 시작하는 경로" },
+      "new_content": { "type": "string",  "description": "교체할 새 내용" },
+      "start_line":  { "type": "integer", "description": "편집 시작 줄 번호 (1-indexed). 없으면 전체 교체" },
+      "end_line":    { "type": "integer", "description": "편집 종료 줄 번호 (포함). 없으면 start_line 단일 줄" },
+      "backup":      { "type": "boolean", "default": false, "description": "true면 .bak 백업 생성" }
+    }
+  },
+  "output": {
+    "oneOf": [
+      {
+        "title": "success",
+        "properties": {
+          "success": { "const": true },
+          "result": {
+            "properties": {
+              "path":          { "type": "string" },
+              "lines_changed": { "type": "integer" },
+              "backup_path":   { "type": ["string", "null"] }
+            },
+            "required": ["path", "lines_changed"]
+          }
+        },
+        "required": ["success", "result"]
+      },
+      {
+        "title": "failure",
+        "properties": {
+          "success": { "const": false },
+          "error":   { "type": "string", "enum": ["INVALID_INPUT","FILE_NOT_FOUND","BINARY_FILE","PERMISSION_DENIED","SIZE_LIMIT"] },
+          "message": { "type": "string" }
+        },
+        "required": ["success", "error", "message"]
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": "full_replace_success",
+      "input": { "path": "__TEST__/config.py", "new_content": "DEBUG = False\n" },
+      "pass_criteria": "success == true and lines_changed >= 1"
+    },
+    {
+      "id": "binary_rejected",
+      "input": { "path": "__TEST__/photo.png", "new_content": "..." },
+      "pass_criteria": "error == BINARY_FILE"
+    },
+    {
+      "id": "missing_path",
+      "input": { "new_content": "x = 1" },
+      "pass_criteria": "error == INVALID_INPUT"
+    }
+  ]
+}