cc-sdd-new-agent — скилл для Claude Code: что делает и как установить
Скилл cc-sdd-new-agent помогает добавить нового coding-агента в cc-sdd по готовому SOP: от исследования формата до тестов и dry-run.
MIT ★ 3 774 обновлён 2026-10-22
npx skills add gotalab/cc-sdd --skill cc-sdd-new-agent -a claude-codeЧто делает cc-sdd-new-agent
Скилл ведёт интеграцию нового агента в tools/cc-sdd. Сначала он предлагает собрать данные об агенте, официальной документации, формате команд и области интеграции, затем создать план в docs/cc-sdd/plans/agent-plan-{agent-id}.md. В план входят исследование, отличия от ближайшего шаблона, список файлов и проверка результата.
После подтверждения плана скилл обновляет tools/cc-sdd/src/agents/registry.ts, добавляет манифест и шаблоны агента, адаптирует YAML frontmatter и создаёт тест реального манифеста. Для интеграции через skills используются пакеты с SKILL.md. Затем выполняются npm test, сборка с dry-run, применение во временной директории, проверки языков и числа сгенерированных файлов. Без подтверждения плана реализация не начинается, если пользователь отдельно не попросил сделать её сразу.
Какие задачи решает
- составить план интеграции нового coding-агента
- исследовать формат команд и frontmatter по официальной документации
- добавить манифест и шаблоны агента в cc-sdd
- проверить результат через тесты и dry-run
Примеры запросов агенту
- Составь план добавления нового агента с id
my-agentи сохрани его вdocs/cc-sdd/plans/agent-plan-my-agent.md. - Добавь поддержку нового агента в
tools/cc-sddпо SOP, сначала подготовь план и дождись моего подтверждения. - Оцени миграцию существующего агента на skills-шаблоны и опиши совместимость, откат и влияние CLI-флагов.
Как установить cc-sdd-new-agent
1Через Skills CLI (Vercel)
npx skills add gotalab/cc-sdd --skill cc-sdd-new-agent -a claude-code2Вручную: положить файлы
~/.claude/skills/cc-sdd-new-agent/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cc-sdd-new-agent/
1Через Skills CLI (Vercel)
npx skills add gotalab/cc-sdd --skill cc-sdd-new-agent -a codex2Вручную: положить файлы
.agents/skills/cc-sdd-new-agent/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gotalab/cc-sdd --skill cc-sdd-new-agent -a cursor2Вручную: положить файлы
.cursor/skills/cc-sdd-new-agent/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gotalab/cc-sdd .agents/skills/cc-sdd-new-agent2Вручную: положить файлы
.github/skills/cc-sdd-new-agent/SKILL.md1Через Skills CLI (Vercel)
npx skills add gotalab/cc-sdd --skill cc-sdd-new-agent -a gemini-cli2Командой платформы
gemini skills install https://github.com/gotalab/cc-sdd --path .agents/skills/cc-sdd-new-agentВручную: положить файлы
.devin/skills/cc-sdd-new-agent/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cc-sdd-new-agent
Как установить cc-sdd-new-agent в Claude Code?
Выполните npx skills add gotalab/cc-sdd --skill cc-sdd-new-agent -a claude-code. Файл скилла появится по пути ~/.claude/skills/cc-sdd-new-agent/SKILL.md.
Что делает cc-sdd-new-agent?
Он проводит добавление или расширение поддержки coding-агента в cc-sdd: создаёт план, подготавливает registry, манифест, шаблоны и тесты, а затем помогает проверить результат.
Поддерживает ли cc-sdd-new-agent Codex?
Да, скилл рассчитан на Claude Code и Codex. Для миграции он предлагает сначала определить стратегию и зафиксировать влияние на совместимость и CLI-флаги.
Исходный текст
SKILL.md · MIT
---
name: cc-sdd-new-agent
description: Add or extend coding-agent support in cc-sdd by executing the SOP in docs/cc-sdd/sop-new-agent.md end-to-end. Use when introducing a new agent, adding a subagent-capable variant, or evaluating migration of an existing supported agent to skills-based templates.
---
# CC-SDD New Agent Integration
## Goal
Add a production-ready agent integration to `tools/cc-sdd` with complete research, implementation, and verification artifacts.
Use the existing SOP and templates in this repository instead of inventing a new process.
## Default Operation Mode
Use `plan-first` as the default:
- First deliverable: `docs/cc-sdd/plans/agent-plan-{agent-id}.md`
- Second deliverable (after plan approval): implementation changes in `tools/cc-sdd/...`
Do not skip the plan document unless the user explicitly requests direct implementation.
## Collect Inputs First
Collect the minimum inputs before editing files:
- Target agent display name and agent id (kebab-case)
- Official documentation URL for command/agent/skills format
- Integration scope: `commands-only`, `commands+agents`, or `skills`
- Whether work type is `new-agent` or `migration`
If any item is unclear, resolve it during Phase 1 research before creating implementation files.
## Execution Workflow
### 1) Run Phase 1 Research
Read `docs/cc-sdd/sop-new-agent.md` and extract all required spec details from official docs:
- commands directory
- agent directory (if supported)
- documentation filename
- command invocation format
- YAML frontmatter schema for commands and agents (or skills)
- placeholders/arguments format
Record exact values (not assumptions) in the plan document.
### 2) Create Plan Document
Copy and fill:
- `docs/cc-sdd/templates/agent-plan-template.md`
Include:
- Phase 1 research summary table
- Differences vs nearest existing agent pattern
- 5-step implementation plan
- changed-file list
- verification plan
Write the completed plan to:
- `docs/cc-sdd/plans/agent-plan-{agent-id}.md`
Before implementation, ensure the plan explicitly states:
- integration scope (`commands-only`, `commands+agents`, `skills`)
- whether this is `new-agent` or `migration`
- compatibility impact and rollback approach
### 3) Choose Base Pattern and Implement
Pick the nearest existing implementation and copy from it:
- `commands-only`: start from `tools/cc-sdd/templates/agents/codex` or another commands-only agent
- `commands+agents`: start from `tools/cc-sdd/templates/agents/claude-code-agent` or `tools/cc-sdd/templates/agents/opencode-agent`
- `skills`: start from `tools/cc-sdd/templates/agents/claude-code-skills`
Start implementation only after the plan file exists and the user has confirmed to proceed.
Apply the standard 5 implementation steps from SOP:
1. Update `tools/cc-sdd/src/agents/registry.ts`
2. Add `tools/cc-sdd/templates/manifests/{agent-id}.json`
3. Add `tools/cc-sdd/templates/agents/{agent-id}/...`
4. Convert YAML frontmatter to target-agent format (keep body unless incompatibility is confirmed)
5. Add `tools/cc-sdd/test/realManifest{AgentName}.test.ts`
For `skills` integration, generate `SKILL.md`-based command packages under `templates/agents/{agent-id}/skills/`.
### 4) Handle Migration Cases
If the request is migration (or migration may be needed), read `references/skills-migration.md` and decide strategy before editing:
- Recommended default: additive migration (`{agent-id}-skills` as a new option)
- Use in-place replacement only when explicitly requested
Always document compatibility impact and CLI flag impact in the plan.
### 5) Verify Before Reporting
Run verification in `tools/cc-sdd`:
- `npm test`
- `npm run build && node dist/index.js --agent {agent-id} --dry-run`
- local temp-directory apply test with `--overwrite=force`
- language checks (`--lang ja`, `--lang en`)
- generated file count checks
If tests cannot run, explicitly report which step is blocked and why.
## Completion Criteria
- Plan file exists at `docs/cc-sdd/plans/agent-plan-{agent-id}.md`
- Registry entry exists and routes to the new manifest id
- Manifest artifacts match target integration scope
- Templates render to expected target directories
- Real manifest test exists and passes
- Dry-run output matches expected artifact plan
- Plan document is updated with research evidence and verification notes
## References
- SOP: `docs/cc-sdd/sop-new-agent.md`
- Plan template: `docs/cc-sdd/templates/agent-plan-template.md`
- Migration guide: `references/skills-migration.md`
- Plan checklist: `references/plan-output-checklist.md`
© gotalab · MIT · gotalab/cc-sdd