CommunityEscrita e Ediçãogithub.com

MoonshotAI/agent-core-review

Use apenas para orientação de revisão de código e escrita/revisão de testes em `packages/agent-core-v2` (o mecanismo de agente DI × Scope). Não se aplica ao `packages/agent-core` legado nem a qualquer outro pacote — para estes, não carregue esta skill. Agrupa as lentes de revisão e teste usadas para agent-core-v2 — `slop` (revisão de camada única de abstração / tratamento de erros em camadas, invocada apenas mediante solicitação explícita) e `test` (regras por teste orientadas por contrato, tanto para autoria quanto para revisão de testes). Aplique a sub-skill que corresponde à tarefa; não aplique `slop` sem ser solicitado.

O que é agent-core-review?

A skill **kc-review** é um conjunto de lentes de revisão e teste, desenvolvido exclusivamente para o pacote `packages/agent-core-v2` — o novo mecanismo de agente baseado em DI (Injeção de Dependência) e Escopo. Ela não deve ser usada no pacote legado `packages/agent-core` nem em nenhum outro. Seu principal objetivo é garantir que o código e os testes do v2 sigam princípios de arquitetura limpa e responsabilidade única, ajudando desenvolvedores a escrever código mais modular e testável. A skill é composta por duas sub-skills independentes: **`slop/`** (Single Level of Abstraction Pattern) que analisa se cada função mantém um único nível de abstração e trata erros na camada correta, sendo acionada apenas quando o usuário explicitamente solicita; e **`test/`** que estabelece regras para escrever e revisar testes orientados por contrato — cada `it` testa um comportamento, utiliza apenas a superfície pública do componente, isola dependências externas e mantém os testes claros, isolados e resistentes a refatorações (CCCR). O roteamento é simples: para revisão de estrutura de código e camadas de abstração, use `slop` (apenas se pedido); para escrever, modificar ou revisar testes, ou para orientação sobre um único teste, use `test`. Essa divisão evita sobrecarga cognitiva e garante que cada ferramenta seja aplicada no contexto adequado. A skill é compatível com assistentes de codificação como Claude Code, Cursor e Codex, sendo ativada automaticamente quando o contexto aponta para o diretório `packages/agent-core-v2`. Seu uso disciplinado ajuda a manter a consistência arquitetural e a qualidade dos testes em todo o desenvolvimento do motor de agente v2.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/agent-core-review

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

kc-review

Escopo: apenas packages/agent-core-v2. Estas lentes são calibradas para o mecanismo v2 (DI × Escopo). Não as aplique ao packages/agent-core legado nem a outros pacotes.

Um pacote das lentes usadas ao revisar ou testar packages/agent-core-v2. Cada sub-skill é autocontida; invoque aquela que corresponde à tarefa.

Sub-skills

  • slop/ — Camada única de abstração e tratamento de erros em camadas. Uma dimensão de revisão: uma função deve ser lida como uma descrição linear de sua própria camada, com erros tratados acima ou abaixo dela. O agente relata detecções e medições, não notas de severidade. Invoque apenas quando o usuário solicitar explicitamente esta lente — não a aplique sem ser solicitado em revisões ou refatorações gerais.
  • test/ — Regras por teste por trás de "teste o contrato / responsabilidade, não a implementação", servindo a dois modos. Modo escrita: crie um teste — um comportamento por it, conduza pela superfície pública, faça stub apenas da verdadeira fronteira externa, controle tempo/configuração através de botões documentados, mantenha os testes claros, isolados e resilientes a refatorações (CCCR). Modo revisão: audite testes existentes contra as mesmas regras e relate descobertas com arquivo:linha. Use ao escrever, modificar ou revisar testes, ou quando perguntado como escrever um bom teste único.

Roteamento

  • Revisar estrutura de código / camadas de abstração / onde o tratamento de erros pertence → slop (apenas mediante solicitação explícita).
  • Escrever ou modificar testes, revisar qualidade de testes ou aconselhar sobre um teste único → test.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

MoonshotAI/agent-core-dev

Use when developing in packages/agent-core-v2 (the DI × Scope agent engine) — adding or modifying a domain Service, choosing a LifecycleScope, wiring DI dependencies, splitting a domain across scopes, owning or migrating a config section, gating behavior behind an experimental flag, raising coded errors, working on the permission system, writing DI/Scope tests, porting business logic from agent-core (v1) to v2, triaging a main-branch commit against v2, or exposing a v2 domain over server-v2 while keeping the /api/v1 wire contract compatible with released clients. Self-contained guide organized by development stage (orient → design → implement → test → verify) plus align workflows for v1→v2 migration, main-branch commit triage, and server-v2 wire exposure; each file carries the rules, examples, and red lines for its step.

MoonshotAI/consolidate

Apply an approved sub-skill grouping by moving user-specified skills into a parent bundle, with timestamped backups of every modified directory.

MoonshotAI/gen-changesets

Use when generating changesets in the kimi-code repository, including package bump selection, internal package and CLI bundle handling, bump levels, major confirmation, and English changelog wording.

MoonshotAI/gen-docs

Update Kimi Code CLI user documentation after meaningful code changes that affect product behavior or user experience.

MoonshotAI/kimi-datasource

Universal data-source assistant. Use this skill when the user wants external structured data such as stocks, financial reports, technical indicators, A-share/HK/US markets, global macroeconomics, Chinese enterprise registry information, arXiv papers, Google Scholar results, or Chinese laws/regulations and judicial cases. This plugin exposes tools via MCP server `plugin-kimi-datasource_data`; call them in the flow `mcp__plugin-kimi-datasource_data__get_data_source_desc` → `mcp__plugin-kimi-datasource_data__call_data_source_tool`.

MoonshotAI/pre-changelog

Use before merging a kimi-code release PR to preview the user-facing CLI changelog in Chinese. Reads the changelog that changesets pre-generated in the release PR, then reuses sync-changelog's strip / classify / translate logic to render a Chinese preview. Writes no files.

MoonshotAI/review

Analyze the available skill set and recommend candidate groups that could be consolidated into sub-skill bundles. Read-only — proposes a plan, does not move files.

MoonshotAI/slop

Invoke only when the user explicitly asks to review code through the "single level of abstraction / layered error handling" lens — a function does only its own layer's business logic while errors are handled above or below. The agent reports detections, raw-count measurements, and move directions. Apply only when the user explicitly requests this lens.

MoonshotAI/sub-skill

Discover and reorganize the skill inventory into hierarchical sub-skill bundles. Use when the user asks to review, group, or consolidate skills into a parent bundle.

MoonshotAI/sync-changelog

Use after a release succeeds, when maintainers need to sync apps/kimi-code/CHANGELOG.md into docs/en/release-notes/changelog.md and docs/zh/release-notes/changelog.md, then open a PR on a dedicated branch.

MoonshotAI/test

Use when writing or reviewing tests, or when asked how to write a good single test. Encodes the per-test rules behind the "test the contract / responsibility, not the implementation" principle — name and structure one behavior per `it`, drive through the public surface, stub only true external boundaries, control time and config via documented knobs, and keep tests clear, isolated, and refactor-resilient. The same rules drive both authoring (write mode) and auditing existing tests (review mode).

MoonshotAI/translate-docs

Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

MoonshotAI/write-tui

Use when writing or modifying the kimi-code terminal UI in apps/kimi-code/src/tui — components, dialogs/selectors, slash commands, themes, streaming render, or the KimiTUI controllers. Covers the architecture, where new features go, test placement, the theme system mechanics, and the dialog interaction/visual spec (DESIGN.md).

Habilidades Relacionadas