bestdeejay-design/agent-skills / skills/dsh-runner
dsh-runner
VerifiedЗапуск автономных агентных задач через DeepSeek Harness (dsh) — изолированные workspace, JSONL-логи сессий, параллельные прогоны. Скрипт dsh_task.py генерирует конфиг и запускает агента через Python SDK (jsonrpc-agent): задача → workspace → harness.run(prompt) → отчёт с final_response и логом. Режимы: headless-задача одной командой, Web UI (npx @deepseek-ai/dsh web), сравнение моделей. Ключ: DEEPSEEK_API_KEY (env) или автоматически из auth.json opencode (провайдер deepseek), либо OpenAI-совместимый endpoint через DEEPSEEK_BASE_URL. Триггеры: 'dsh', 'deepseek harness', 'агент в песочнице', 'изолированный агент', 'запусти агента на репо', 'агентная задача', 'агент-исполнитель', 'harness run', 'agent harness', 'запустить dsh', 'автономная задача агентом', 'параллельные агенты', 'сравнить модели на задаче', 'jsonrpc-agent'.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.9 KB |
| references/runbook.md | markdown | 4.8 KB |
| scripts/dsh_task.py | script | 5.0 KB |
| skill.json | config | 2.4 KB |
scripts/dsh_task.py
View on GitHub#!/usr/bin/env python3
"""dsh_task.py — запуск одной агентной задачи через DeepSeek Harness SDK.
Требует: deepseek-harness-sdk (pip install), DEEPSEEK_API_KEY или
DEEPSEEK_BASE_URL (OpenAI-совместимый endpoint).
Ключ ищется в таком порядке:
1. env DEEPSEEK_API_KEY
2. auth.json opencode (провайдер `deepseek`) — ~/.local/share/opencode/auth.json,
затем ~/.config/opencode/auth.json
Пример:
DEEPSEEK_API_KEY=sk-... python3 dsh_task.py \
--workspace /tmp/ws/repo --session-root /tmp/sessions \
--session-id fix-001 "Почини падающий тест."
Exit codes: 0 = задача завершена (final_response есть), 2 = ошибка запуска.
"""
from __future__ import annotations
import argparse
import json
import os
import sys
from pathlib import Path
OPENCODE_AUTH_CANDIDATES = (
Path.home() / ".local" / "share" / "opencode" / "auth.json",
Path.home() / ".config" / "opencode" / "auth.json",
)
def load_deepseek_key_from_opencode() -> str | None:
"""Читает ключ DeepSeek из auth.json opencode (без вывода в логи)."""
for auth_path in OPENCODE_AUTH_CANDIDATES:
try:
data = json.loads(auth_path.read_text(encoding="utf-8"))
except (OSError, json.JSONDecodeError):
continue
provider = data.get("deepseek") or {}
key = provider.get("key")
if isinstance(key, str) and key.strip():
return key.strip()
return None
def resolve_api_key() -> str | None:
"""Возвращает ключ из env или auth.json opencode, либо None."""
env_key = os.environ.get("DEEPSEEK_API_KEY")
if env_key and env_key.strip():
return env_key.strip()
if os.environ.get("DEEPSEEK_BASE_URL"):
return None
return load_deepseek_key_from_opencode()
def parse_args() -> argparse.Namespace:
p = argparse.ArgumentParser(description="Run a single agent task via DeepSeek Harness SDK")
p.add_argument("--workspace", required=True, help="absolute path to the task workspace (agent's cwd)")
p.add_argument("--session-root", required=True, help="absolute path where session logs are stored")
p.add_argument("--session-id", default="task-001", help="unique session id (per task)")
p.add_argument("--model", default=None, help="model id; default from DSH_MODEL or deepseek-v4-flash")
p.add_argument("--provider", default=None, help="provider id; default 'deepseek-official'")
p.add_argument("--max-tokens", type=int, default=49152, help="max model tokens per task")
p.add_argument("--cordis", default=None, help="path to cordis composition yml (jsonrpc-agent minimal by default)")
p.add_argument("prompt", help="the task prompt for the agent")
return p.parse_args()
def main() -> int:
args = parse_args()
workspace = Path(args.workspace).resolve()
session_root = Path(args.session_root).resolve()
session_root.mkdir(parents=True, exist_ok=True)
if not workspace.is_dir():
print(f"[dsh_task] workspace does not exist: {workspace}", file=sys.stderr)
return 2
api_key = resolve_api_key()
if not api_key and not os.environ.get("DEEPSEEK_BASE_URL"):
print(
"[dsh_task] no DEEPSEEK_API_KEY found: set the env var, or run "
"`opencode auth login` / add the `deepseek` provider to opencode auth.json",
file=sys.stderr,
)
return 2
if api_key:
source = "env" if os.environ.get("DEEPSEEK_API_KEY") else "opencode auth.json"
os.environ["DEEPSEEK_API_KEY"] = api_key
print(f"[dsh_task] DEEPSEEK_API_KEY from {source}")
model = args.model or os.environ.get("DSH_MODEL", "deepseek-v4-flash")
provider = args.provider or os.environ.get("DSH_PROVIDER", "deepseek-official")
try:
from deepseek_harness import DeepSeekHarness # type: ignore
except ImportError:
print("[dsh_task] pip install deepseek-harness-sdk first", file=sys.stderr)
return 2
kwargs: dict = {
"provider": provider,
"model": model,
"max_tokens": args.max_tokens,
"cwd": str(workspace),
"session_root": str(session_root),
}
if args.cordis:
kwargs["cordis"] = args.cordis
print(f"[dsh_task] workspace={workspace} model={model} session_id={args.session_id}")
try:
with DeepSeekHarness(**kwargs) as harness:
result = harness.run(args.prompt, session_id=args.session_id)
except Exception as exc: # SDK is preview; surface raw error
print(f"[dsh_task] harness error: {exc}", file=sys.stderr)
return 2
report = {
"session_id": getattr(result, "session_id", args.session_id),
"final_response": getattr(result, "final_response", ""),
"finish_reason": getattr(result, "finish_reason", None),
"session_root": str(session_root),
}
print(json.dumps(report, ensure_ascii=False, indent=2))
return 0
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |