菜单
MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | agentic-acp-protocol-flow |
| description | MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim. |
Use this skill for ACP runtime behavior. For schema facts, also load
agentic-acp-docs-and-schema.
ACPClient in acp_client.lua.config_default.lua entry under acp_providers unless
the provider deviates from ACP in a new way.ACPClient methods, not adapter files.provider subprocess
-> ACPTransport
-> ACPClient
-> SessionManager subscriber
-> MessageWriter / PermissionManager / TodoList / ChatHistory
references/client-lifecycle.md: ACPClient.state, ready listeners, sync vs
async dispatch, reconnect, pending callback draining.references/transport-framing.md: stdio line framing, partial chunks,
subprocess process-group termination.references/tool-calls-permissions.md: session/update routing, tool-call
lifecycle, permission request normalization, provider quirks.references/provider-switch-options.md: provider switch replay, modes/models,
thought level, config options.Current extension points:
| Method | Behavior |
|---|---|
__handle_tool_call | Builds ToolCallBlock, notifies subscriber |
__build_tool_call_message | Parses ACP fields and quirk fallbacks |
__handle_tool_call_update | Builds partial, notifies subscriber |
__handle_request_permission | Sends permission result to provider |
__handle_session_update | Routes by sessionUpdate type |
Only subclass or extend these when a real provider deviation requires it.
Handle protocol deviations inline in __build_tool_call_message.
rawInput fallback builds diffs when content is missing for edit
tool calls.locations fallback extracts file_path from update.locations[0].path.MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD. Covers mini.test workflow, red/green rules, commands, mark-count checks, and which test references to load.
MANDATORY before writing or editing ANY .lua file in this repo - classes, methods, fields, functions, or LuaCATS annotations. Holds the project's enforced Lua style: class pattern, visibility prefixes (_private, __protected), and optional-type syntax. Skipping it produces luals/selene failures at make validate. Load it before the first edit, not after.
Use when ACP schema is necessary to clarify the work or when the user asks for ACP data, rules, events, or documentation
Use when creating, listing, or managing GitHub discussions in carlos-algms/agentic.nvim repository
Use when neovim documentation is needed for the current task or the user asks for specific neovim features or neovim lua apis. It gives instructions on how to read current Neovim's documentation locally and offline, and also how to read online if it fails
MANDATORY before editing runtime Lua under lua/agentic, except pure tests or docs. Covers multi-tab safety, public API session resolution, scoped Neovim state, buffer/window/keymap isolation, and scheduled callback rules.