К основному содержанию
скилл CX Codex

widen-return-type — скилл для Claude Code: что делает и как установить

Скилл widen-return-type для правок TypeScript: расширяет возвращаемый тип функции через перегрузки, не теряя узкие типы в местах вызова.

MIT ★ 539 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a claude-code
Открыть на GitHub

Что делает widen-return-type

Скилл задаёт порядок правки, когда функции нужен более широкий возвращаемый тип ради расширяемости. Узкие типы при этом сохраняются перегрузками TypeScript: старый вызов продолжает видеть конкретный тип, новый получает общий. Приводить типы вручную не требуется.

Второе требование — повторять уже принятый в проекте паттерн opt-in, а не изобретать свой. Значит: отдельная константа с картой инструментов, условное слияние в agents/index.ts и тесты, которые проверяют и выключенное, и включённое состояние. Новый механизм гейтинга фича-флагов скилл прямо запрещает, так что правка с самодельной схемой ревью не пройдёт.

Ревьюер сверяет дифф: каждое обязательное действие должно быть в изменениях. При делегировании задачи в промпт подставляют строку SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md, иначе субагент про этот порядок не узнаёт.

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

  • Расширить возвращаемый тип функции, не сломав узкие типы у вызывающего кода
  • Заменить приведение типов аккуратными перегрузками TypeScript
  • Провести новый инструмент через фича-флаг по уже принятой в проекте схеме
  • Покрыть тестами выключенное и включённое состояние гейтинга
  • Сверить дифф со списком обязательных шагов до мержа

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

  • Расширь возвращаемый тип loadTools() через перегрузки, узкие типы у вызовов сохрани.
  • Заведи opt-in tool map отдельной константой и слей её в agents/index.ts под фича-флагом.
  • Добавь gating-тесты на выключенный и включённый режим и проверь, что в диффе есть все шаги.

Как установить widen-return-type

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a claude-code

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

~/.claude/skills/widen-return-type/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/widen-return-type/

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

Вопросы о widen-return-type

Как установить widen-return-type в Claude Code?

Выполните npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a claude-code. Файл скилла окажется в ~/.claude/skills/widen-return-type/SKILL.md.

Что делает widen-return-type?

Описывает, как расширять возвращаемый тип функции через перегрузки и как повторять существующий паттерн opt-in: отдельная карта инструментов, условное слияние в agents/index.ts, тесты на оба состояния флага.

Что нужно, чтобы скилл сработал при делегировании?

В промпт задачи добавляют строку SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md. Ревьюер затем проверяет, что каждое обязательное действие видно в диффе.

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

SKILL.md · MIT
---
name: widen-return-type
description: widen return type
metadata:
  triggers: '["widen return type","opt-in tool map","feature flag gating","tool registration"]'
  generated_from_knowledge: '[]'
  source_knowledge_ids: '[]'
  generated_at: "2026-07-02T02:11:00.606Z"
  confidence: "0.60"
  status: active
  version: "2"
  skill_origin: generated
---

<!-- generated by opencode-swarm skill-generator. Do not edit by hand; edits will be preserved on regeneration only with controlled update mode. -->

# widen return type

## Trigger

- widen return type
- opt-in tool map
- feature flag gating
- tool registration

## Required Procedure

- use TypeScript overloads to preserve narrow return types when widening a function's return type for extensibility
- mirror existing opt-in pattern: separate tool map constant, conditional merge in agents/index.ts, gating tests verifying disabled and enabled states

## Forbidden Shortcuts

- invent new tool-gating mechanisms for opt-in feature flags

## Delegation Template

When delegating a task affected by this skill, include:

```
SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md
```

## Reviewer Checks

- Verify each required action above appears in the diff.</item>

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Похожие скиллы

Все скиллы по теме «Языки программирования» →
type-migrator rohitg00 Плагин type-migrator переводит файлы проекта с JavaScript на TypeScript и расставляет точные типы данных. Запускается при пошаговой модернизации легаси-кода. ★ 2 858звёзд репо 122-java-type-design Juan Antonio Breña Moral Скилл 122-java-type-design для ревью и рефакторинга Java-кода: убирает primitive obsession, строит иерархии типов и подсказывает, где нужен BigDecimal. CX Codex +1 418установок principle-type-system-discipline backnotprop Скилл principle-type-system-discipline для Claude Code помогает проектировать типы, проверять сигнатуры и разбирать внешние данные. Подключается при работе со статически типизированным кодом. CX Codex +1 10 300установок ban-type-assertions Factory-AI Скилл ban-type-assertions для Claude Code запрещает утверждения типов as и помогает заменить их проверяемыми компилятором решениями. Запускается при настройке запрета в пакете или исправлении ошибок линтера. CX Codex +1 151установок remove-feature-flag dominikmartn Скилл remove-feature-flag для Claude Code удаляет устоявшийся feature flag из Warp: конфигурацию, проверки и мёртвые ветки. Запускается после включения функции для всех пользователей. CX Codex +1 ★ 720звёзд репо typescript-type-expert carlrannaberg Субагент typescript-type-expert помогает проектировать сложные типы в TypeScript, исправлять рекурсию и ошибки инференса в дженериках. CX Codex ★ 763звёзд репо

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

Весь набор →
propagation-test Скилл propagation-test задаёт порядок проверки изменений в общем модуле: затроньте его общий интерфейс и проверьте всех потребителей без отдельных переопределений. CX Codex +1 ★ 539звёзд репо ci-failure-batching Скилл ci-failure-batching требует прогнать весь набор тестов проекта его собственной командой, прежде чем агент скажет, что тесты прошли. CX Codex +1 ★ 539звёзд репо swarm-pr-review Скилл swarm-pr-review для Claude Code подключает канонический воркфлоу ревью пулреквестов из .opencode к сессиям. CX Codex +1 ★ 539звёзд репо running-tests Скилл running-tests для Claude Code безопасно запускает тесты opencode-swarm: проверяет отдельные файлы и изменения, валидирует набор тестов как в CI и диагностирует ошибки без зависания сессии. CX Codex +1 ★ 539звёзд репо swarm-pr-review Скилл swarm-pr-review для Claude Code и Codex — тонкий адаптер для роевого ревью пуллреквестов, передающий исполнение каноническому протоколу в .opencode. CX Codex +1 ★ 539звёзд репо spread-real-module-exports-as-base-of-every-mock-module-return-o Скилл spread-real-module-exports-as-base-of-every-mock-module-return-o для Claude Code задаёт правило для объектов, которые возвращает mock.module. Он срабатывает при работе с этим паттерном и встроенным мокированием node:. CX Codex +1 ★ 539звёзд репо gate-attribution Скилл gate-attribution описывает, как отправлять reviewer и test_engineer на проверку так, чтобы трекер гейтов засчитал каждый вызов: один taskId на вызов и параллельные полосы. CX Codex +1 ★ 539звёзд репо swarm-implement Скилл swarm-implement адаптирует канонический воркфлоу opencode-swarm под сложные доработки кода, фиксы в нескольких файлах и многоэтапный рефакторинг. CX Codex +1 ★ 539звёзд репо

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

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