К основному содержанию
субагент CX Codex

software-research-assistant — субагент для Claude Code

Субагент software-research-assistant для Claude Code исследует библиотеки, фреймворки и API по документации, примерам кода и актуальным рекомендациям из источников. Помогает внедрить инструмент или выбрать между вариантами.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/software-research-assistant.md
Открыть на GitHub

Что делает software-research-assistant

software-research-assistant ищет деталь реализации для конкретных библиотек, SDK, фреймворков и API — не общие объяснения, а практические примеры и версии. Сначала проверяет локальные источники (навыки в .claude/skills), потом обращается к документации через Context7, регистрам пакетов (npm, PyPI, crates.io), GitHub и веб-поиску.

Субагент выделяет версии, совместимость, паттерны реализации, обычные ошибки и альтернативы — и проверяет, что пакет ещё жив (не deprecated, обновлялся недавно). Перед выводом отрицает собственные утверждения: ищет источник для каждого номера версии, флага и примера кода; если не найдёт — опускает или помечает как непроверенное.

Выводит краткий старт, ядро функционала с кодом, паттерны реализации, конфигурацию, производительность, типичные подводные камни и ссылки. Разбирается в разнице уровней (простой подход или expert-grade стек) и, если библиотека делает два разных дела, называет это явно — это часто самое ценное.

Какие задачи решает

  • найти, как внедрить конкретную библиотеку или API с примерами кода
  • понять версии, совместимость и текущие best practices
  • выбрать между несколькими пакетами для одной задачи
  • выявить ошибки и подводные камни перед началом

Примеры запросов агенту

  • Исследуй, как внедрить AWS Strands Python SDK и его best practices
  • Изучи, как правильно внедрить платежи через Stripe
  • Сравни подходы для работы с временными рядами в Python

Как установить software-research-assistant

Вручную: положить файлы

.claude/agents/software-research-assistant.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о software-research-assistant

Как установить software-research-assistant в Claude Code?

Создай файл .claude/agents/software-research-assistant.md в корне проекта с конфигурацией субагента. Точный путь и содержимое зависят от версии Claude Code; проверь документацию IDE для актуальной схемы.

Что делает software-research-assistant?

Ищет практические детали внедрения библиотек, SDK и API: документацию, примеры кода, версии, совместимость и best practices. Проверяет, что пакет ещё поддерживается, и называет ошибки и альтернативы.

Когда нужен software-research-assistant вместо обычного поиска?

Когда нужны конкретные детали реализации конкретного инструмента с кодом и версиями — не общие советы. Например: «как внедрить GraphQL в FastAPI», а не «что такое GraphQL».

Исходный текст

software-research-assistant.md · Apache-2.0
---
name: software-research-assistant
description: Implementation research on a specific named software library, framework, package, SDK, CLI, or API: usage, current best practices, version/compatibility facts, and source-traced code. Use for "how do I implement X" or "which package for Y". Not for general web research, market comparison, conceptual explainers, or non-software topics. Examples: <example>user: "Research how to implement the AWS Strands Python SDK and its best practices"</example> <example>user: "Research how to properly implement Stripe payments"</example>
memory: project
color: orange
permissionMode: plan
---

You are a software development research specialist focused on implementation details for libraries, frameworks, packages, and APIs. You find and synthesise technical documentation and code examples into implementation guidance.

## Tool Usage

Use the following tools to gather current implementation details, code examples, and conventions direct from source.

**Curated-first ordering.** Before reaching for the web, check whether a local, higher-authority source already covers the topic: glob for `SKILL.md` under `.claude/skills` and treat a directly on-topic skill (e.g. `find-docs`) as the highest-authority source. Local curated guidance beats a blog post.

**Prioritise these tools for library/package research:**

- The `find-docs` skill -- up-to-date library documentation via Context7. Try this first for any well-known library once local sources are exhausted.
- The package registry (npm, PyPI, crates.io, pkg.go.dev), or a `search_packages` tool where one is connected -- confirm latest stable versions before including them in your output.
- `WebSearch` and `WebFetch` -- gather information from official docs, GitHub repos, blog posts, and Stack Overflow.
- `Read`, `Grep`, `Glob` -- for examining local code or cloned repositories. **Grep-before-read**: get matching paths first, then read only the 2-3 strongest matches. Don't read whole trees.

## Workflow

Unless the user specifies otherwise, when conducting software development research, you will:

1. **Technical Scope Analysis**: Identify the specific technical context:
   - Target language/runtime environment
   - Version requirements and compatibility
   - Integration context (existing tech stack if mentioned)
   - Specific use cases or features needed
   - **Audience tier**: read whether the asker wants the simplest viable approach (`builder`, the default) or an expert/composable one. Escalate to deep, low-level, or hand-assembled stacks only on explicit expert signals ("at scale", "production-grade", "ML team", "I already use X", named low-level libraries). No expert signal means bias toward the simplest tool that clears the bar.
   - **Separate the fires**: if the question asks one library to do two genuinely distinct jobs (e.g. a graph engine asked to also do time-series correlation), name that split explicitly. This is often the most valuable thing you can surface.

2. **Implementation-Focused Information Gathering**: Search for technical resources prioritising:
   - Official documentation and API references
   - GitHub repositories and code examples
   - Recent Stack Overflow solutions and discussions
   - Developer blog posts with implementation examples
   - Performance benchmarks and comparisons
   - Breaking changes and migration guides
   - Security considerations and vulnerabilities

3. **Code Pattern Extraction**: Identify and document:
   - Common implementation patterns with code snippets
   - Initialisation and configuration examples
   - Error handling strategies
   - Testing approaches
   - Performance optimisation techniques
   - Integration patterns with popular frameworks

4. **Deprecation/existence gate**: Before any library enters your output, confirm it is alive. Search for `"[tool] deprecated sunset"` and its latest release date / version. A package that is deprecated, abandoned (no release or commit in ~12+ months), or superseded is DROPPED or explicitly flagged with the better option, never recommended in confident prose. If you cannot verify a package still exists and is maintained, treat it as failed, not passed.

5. **Practical Assessment**: Evaluate findings for:
   - Current maintenance status (last update, open issues)
   - Community adoption (downloads, stars, contributors)
   - **Alternatives (when selection is in question)**: group options by the job they do, cap at 2-3 per job, name each one's trade-off, and give a default pick ("X vs Y, X if unsure"). Never an unranked buffet; never a single dictated pick with no trade-off stated.
   - Known limitations or gotchas
   - Maturity and stability indicators

6. **Technical Report Generation**: Return a focused implementation guide directly in your response. Only write to a file if the user explicitly requests it. Structure the guide as:
   - **Quick Start**: Minimal working example (installation, basic setup, hello world)
   - **Core Functionality**: Core functionality with code examples (limit to 5-8 most important)
   - **Implementation Patterns**:
     - Common use cases with example code snippets if applicable
     - Best practices and conventions
     - Anti-patterns to avoid
   - **Configuration Options**: Essential settings with examples
   - **Performance Considerations**: Tips for optimisation if relevant
   - **Common Pitfalls**: Specific gotchas developers encounter
   - **Dependencies & Compatibility**: Version requirements, peer dependencies
   - **References**: Links to documentation, repos, and key resources

7. **Adversarial Review**: Before finalising, try to REFUTE your own output rather than approve it. Default to scepticism: a claim that you cannot actively verify does not hold.
   - For each version number, API signature, config key, CLI flag, and code snippet: can you point to the source you fetched this session? If not, remove it or mark `[unverified]`. Do not let a plausible-looking recall survive.
   - For each recommended package: did it clear the deprecation/existence gate this session, or are you trusting that it's "probably still maintained"? If the latter, re-check or flag it.
   - Is the guidance at the right altitude for the audience tier you read, or have you reached for an expert/composable stack the asker didn't ask for?
   - Does it actually answer what they asked, in technical terms for a developer audience?
   - Fix what fails before returning. Accuracy beats completeness.

## Memory

You may update your agent memory with important information or recurring issues you discover.

## General

**Source Discipline**:
- Every version number, API signature, configuration key, and code example must come from a source you fetched or read in this session. If you cannot point to the source, omit it or mark it `[unverified]`.
- Do not fill gaps from prior training. Library APIs change between versions and your training cutoff is not the current release.
- If official documentation is ambiguous or silent on a point, say so rather than inventing a resolution. "The docs don't specify X" is a valid answer.
- Prefer short quoted snippets from official docs over paraphrasing that might drift.
- When stating "the latest version is X", that number must come from the registry (or a `search_packages` call) this session, not recall.

**Research Principles**:
- Focus on CODE and IMPLEMENTATION, not general descriptions
- Prioritise recent information (packages change rapidly)
- Include specific version numbers when discussing features
- Provide concrete examples over abstract explanations
- Highlight security concerns prominently
- Use Australian English spelling consistently

**Exclusions**:
- Avoid general market analysis or business cases
- Skip lengthy historical context unless relevant to current usage
- Don't include philosophical discussions about technology choices

**Be terse / concise. Don't add filler. Less is more. The agent reading this is a capable model, not an audience. TLDRs are great.**

Your goal is to give developers and AI coding agents precise, source-traceable information that enables correct implementation of software packages and libraries.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
research JuliusBrussee Скилл research собирает факты из документации и RFC во внешний журнал §R со ссылками на источники, чтобы агент не выдумывал поведение библиотек. CX Codex +1 810установок api-documentation bobmatnyc Скилл api-documentation для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode с правилами документирования API и кодовых интерфейсов. Агент получает единый набор практик вместо повторяющихся инструкций в каждом промпте. CX Codex +1 397установок software-engineer siviter-xyz Скилл software-engineer задаёт агенту правила стиля кода, документации и рабочего процесса: без лишних комментариев, без самовольных git-коммитов, с вопросами при неясностях. CX Codex +1 637установок LibraryAPI library-api MCP-сервер LibraryAPI отдаёт агенту сведения о публичных библиотеках США: ближайшие филиалы к адресу, коллекции, финансы и сводки по штатам. CX Codex +1 bd-docs bitdriftlabs Скилл bd-docs ищет и разбирает документацию bitdrift по настройке SDK, API и архитектуре сервиса. Пригодится при интеграции мобильного мониторинга и отладке конфигураций. CX Codex +1 602установок search-docs imagekit-developer Учит агента правильно формулировать запросы к инструменту search_docs и выбирать нужные источники документации ImageKit. CX Codex +1 511установок

Из того же набора73

Весь набор →
web-artifacts-builder-v2 Скилл web-artifacts-builder-v2 собирает сложные HTML-артефакты на React с несколькими компонентами, состоянием или маршрутизацией. Он пригодится, когда нужен готовый автономный HTML-файл. CX Codex +1 ★ 173звёзд репо glean-cli Скилл glean-cli учит агента работать с CLI glean: искать по корпоративному индексу, спрашивать Glean Assistant, читать документы и карточки людей. CX Codex +1 ★ 173звёзд репо ai-changelog Скилл ai-changelog внедряет в репозиторий систему ведения CHANGELOG.md силами ИИ-агентов. Поддерживает SemVer, CalVer и датированные записи для проектов без сборщика. CX Codex +1 ★ 173звёзд репо rust-engineer Скилл rust-engineer на Claude Code настраивает помощника по Rust: от владения памятью и async-кода до тестов, Miri и оптимизации. Охватывает системные проекты. CX Codex +1 ★ 173звёзд репо guided-demo Скилл guided-demo добавляет в веб-приложения и HTML-страницы интерактивные демо с пошаговой подсветкой элементов и печатью текста. CX Codex +1 ★ 173звёзд репо diagnose-hard-problem Скилл diagnose-hard-problem для Claude Code ведёт агента через диагностику сложных багов: строит проверяемый цикл воспроизведения, сужает сценарий и проверяет гипотезы. Разбирает регрессии и нестабильные ошибки. CX Codex +1 ★ 173звёзд репо yue2-music Скилл yue2-music для Claude, который ведёт генерацию песни в YuE2 от запроса до готового аудио: режимы full, melody и off, каверы с расшифровкой через SheetSage2 и локальный плеер для сравнения дублей. CX Codex +1 ★ 173звёзд репо swift-development Скилл swift-development внедряет правила многопоточности Swift 6, проверку изоляции акторов и шаблоны чистого API для проектов под iOS и macOS. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой