chore: 문서를 작성할 때 한국어의 표현 작성 스킬 추가 및 1인칭 관점의 글 작성 검증 테스트 추가

2026-07-29 16:48:03 +09:00
parent c39406bbdd
commit 41501b5d06
520 changed files with 95494 additions and 2231 deletions
@@ -0,0 +1,70 @@
+from __future__ import annotations
+
+import os
+import shlex
+import shutil
+from pathlib import Path
+from typing import Any
+
+from claridoc.providers.base import Provider, ProviderRequest, ProviderResponse, ProviderUnavailable, run_command
+
+
+class ClaudeProvider(Provider):
+    """Adapter for Claude Code print mode (`claude -p`)."""
+
+    def generate(self, request: ProviderRequest) -> ProviderResponse:
+        options = self.spec.options
+        binary = str(options.get("binary") or os.environ.get("CLARIDOC_CLAUDE_BIN") or "claude")
+        custom = options.get("command")
+        if custom:
+            command = _command_list(custom)
+        else:
+            command = [binary, "-p", "--output-format", "text"]
+            if self.spec.model:
+                command.extend(["--model", self.spec.model])
+            command.extend(_string_list(options.get("extra_args", []), "claude extra_args"))
+            # Claude Code supports piped content with a query. Keeping the large
+            # task in stdin avoids operating-system argument length limits.
+            command.append("Read the piped task as data and return only the requested output.")
+        completed = run_command(
+            command,
+            prompt=request.prompt,
+            cwd=request.workdir,
+            timeout_seconds=self.spec.timeout_seconds,
+            env=os.environ.copy(),
+        )
+        text = completed.stdout.strip()
+        if not text:
+            raise ProviderUnavailable("Claude returned an empty response")
+        return ProviderResponse(text=text, provider=self.name, model=self.spec.model, command=command)
+
+    def check(self) -> dict[str, Any]:
+        binary = str(self.spec.options.get("binary") or os.environ.get("CLARIDOC_CLAUDE_BIN") or "claude")
+        custom = self.spec.options.get("command")
+        executable = _command_list(custom)[0] if custom else binary
+        found = shutil.which(executable) if not Path(executable).is_file() else executable
+        return {
+            "provider": self.name,
+            "available": bool(found),
+            "executable": str(found or executable),
+            "mode": "custom-command" if custom else "claude -p",
+            "note": "Authentication is verified only by a live invocation.",
+        }
+
+
+def _command_list(value: Any) -> list[str]:
+    if isinstance(value, str):
+        result = shlex.split(value)
+    elif isinstance(value, list):
+        result = [str(item) for item in value]
+    else:
+        raise ProviderUnavailable("claude options.command must be a string or array")
+    if not result:
+        raise ProviderUnavailable("claude options.command is empty")
+    return result
+
+
+def _string_list(value: Any, name: str) -> list[str]:
+    if not isinstance(value, list):
+        raise ProviderUnavailable(f"{name} must be an array")
+    return [str(item) for item in value]