ds-ledger — скилл для Claude Code: что делает и установка
Скилл для Claude Code ведёт журнал решений во время долгой или автономной работы. Активируется для многоэтапных задач и работы, которую позже проверит человек, или по команде /ds-ledger.
MIT 545 установок ★ 320 обновлён 2026-10-28
npx skills add aicodeking/deepseek-stack --skill ds-ledger -a claude-codeЧто делает ds-ledger
Скилл создаёт TSV-журнал: в первой строке фиксирует цель и условие завершения, а после каждого решения добавляет фазу, выбор, причину, подтверждение и результат. Перед каждым шагом агент перечитывает цель и последние десять записей, чтобы сверить дальнейшую работу с задачей.
Подтверждением служит ссылка на проверяемый артефакт: например, хеш коммита, file:line или путь к файлу. Каждое поле занимает одну строку; старые записи не переписываются, исправления добавляются отдельно. Откаты и неудачи тоже попадают в журнал. Если три записи подряд показывают отсутствие прогресса, агент останавливается и сообщает об этом; в конце добавляет итоговую строку и указывает файл.
Какие задачи решает
- вести журнал решений в долгом запуске агента
- сверять каждый шаг с исходной целью
- сохранять причины откатов и неудач
- передать проверяющему журнал с подтверждениями
Примеры запросов агенту
- Веди журнал решений для этой многоэтапной задачи через
/ds-ledger. - Работай автономно и записывай решения с подтверждениями командой
/ds-ledger. - Подготовь журнал, чтобы человек позже проверил результат:
/ds-ledger.
Как установить ds-ledger
1Через Skills CLI (Vercel)
npx skills add aicodeking/deepseek-stack --skill ds-ledger -a claude-code2Вручную: положить файлы
~/.claude/skills/ds-ledger/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ds-ledger/
1Через Skills CLI (Vercel)
npx skills add aicodeking/deepseek-stack --skill ds-ledger -a codex2Вручную: положить файлы
.agents/skills/ds-ledger/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add aicodeking/deepseek-stack --skill ds-ledger -a cursor2Вручную: положить файлы
.cursor/skills/ds-ledger/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install aicodeking/deepseek-stack skills/ds-ledger2Вручную: положить файлы
.github/skills/ds-ledger/SKILL.md1Через Skills CLI (Vercel)
npx skills add aicodeking/deepseek-stack --skill ds-ledger -a gemini-cli2Командой платформы
gemini skills install https://github.com/aicodeking/deepseek-stack --path skills/ds-ledgerВручную: положить файлы
.devin/skills/ds-ledger/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add aicodeking/deepseek-stack --skill ds-ledger -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ds-ledger
Как установить ds-ledger в Claude Code?
Выполни npx skills add aicodeking/deepseek-stack --skill ds-ledger -a claude-code. Файл скилла находится по пути ~/.claude/skills/ds-ledger/SKILL.md.
Что делает ds-ledger?
Он ведёт TSV-журнал решений и перед каждым шагом сверяет работу с записанной целью. В журнал попадают причины решений, подтверждения, результаты, откаты и неудачи.
Когда ds-ledger останавливает работу?
Если три записи подряд показывают отсутствие прогресса к цели, скилл останавливает запуск и сообщает об этом.
Исходный текст
SKILL.md · MIT
--- name: ds-ledger description: "Keep a one-row-per-decision log during long or unattended runs, and re-read it before each step so the run does not drift from its goal. Use for multi-phase or autonomous work, work a human will review later, or /ds-ledger." --- # ds-ledger A long run forgets its own reasons. A short written ledger keeps the goal in view and lets a reviewer trust the result. ## Steps 1. Create one TSV file, for example `.ds-ledger.tsv`, with the header `ts phase decision why evidence result`. Put the goal and done condition in the first row. 2. Before each step, re-read the goal row and the last ten rows. Check that the next step still serves the goal. If it does not, log the drift and correct course. 3. After each real decision, append one row: - ts: ISO 8601 time. - phase: the phase or workstream. - decision: what you chose or did, one line. - why: the reason in plain words. - evidence: a pointer, never prose. A commit hash, `file:line`, a command and its result, or an artifact path. - result: the outcome, such as "tests pass", "reverted", "open". 4. Keep each cell on one line with no tabs. 5. Log reverts and dropped work too, with the reason. Failures are the most useful rows. 6. At the end, add a summary row and point the user to the file. Commit it only if a reviewer needs it. ## Stop when - The run ends and the summary row is written. - If three rows in a row show no progress toward the goal, stop the run and report. ## Rules - Every row needs evidence you can open or rerun. "Looked fine" is not evidence. - Write rows the way you would tell a teammate, plain and concrete. - Do not rewrite old rows. Append corrections.
© aicodeking · MIT · aicodeking/deepseek-stack