菜单
Authors and maintains ZCode AGENTS.md instruction files at user or workspace scope. Use when adding default agent instructions, editing AGENTS.md, deciding user-vs-workspace scope, or reasoning about the load and merge order of instruction files in ZCode.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Authors a ZCode slash command as commands/<name>.md in a marketplace. Use when adding or defining a slash (/) command, including nested colon-separated commands. For a SKILL.md use add-skill; for a subagent use add-agent.
Scaffolds a new self-contained ZCode marketplace — a complete ~/.zcode setup — under zcode_tools/marketplaces/. Use when creating a brand-new setup or profile such as nddev-builder or nddev-designer, or bootstrapping a marketplace directory from scratch.
Scaffolds a new self-contained plugin bundle inside a ZCode marketplace and registers it in marketplace.json. Use when adding a plugin to a marketplace, or grouping skills, commands, and agents into one installable bundle.
Adds a model provider to a marketplace's config template. Use when adding or configuring an LLM provider — OpenAI, Anthropic, or a custom OpenAI-compatible endpoint — or wiring provider models, base URL, or API-key placeholders into a ZCode setup.
Authors a ZCode skill (SKILL.md) inside a plugin bundle or at user scope. Use when adding a skill or teaching the agent a reusable workflow. For a slash command use add-command; for a subagent use add-agent.
Runs an isolated install-and-verify loop for a marketplace using temporary HOME and ZCODE_HOME, proving components flatten and load without touching live ~/.zcode. Use to behaviorally test a plugin during development, after static validation.
| name | add-instructions |
| description | Authors and maintains ZCode AGENTS.md instruction files at user or workspace scope. Use when adding default agent instructions, editing AGENTS.md, deciding user-vs-workspace scope, or reasoning about the load and merge order of instruction files in ZCode. |
AGENTS.md is ZCode's instruction surface — broad behavior rules injected into
the model context. It is not a skill, command, hook, MCP server, or plugin; it
has its own two scopes and a defined merge order.
| Scope | File | Applies to | Loads |
|---|---|---|---|
| User | ~/.zcode/AGENTS.md | every workspace | first |
| Workspace | <repo>/AGENTS.md | that project only | after user (can narrow/override) |
ZCode injects ~/.zcode/AGENTS.md first, then the workspace AGENTS.md resolved
from the current directory upward to the project root — so workspace rules
appear later and take precedence for that repo.
A marketplace ships its own AGENTS.md at its root; the installer renders it to
~/.zcode/AGENTS.md (user scope). Edit the marketplace's AGENTS.md to change
the installed user-scope defaults.
~/.zcode/AGENTS.md, i.e. the marketplace AGENTS.md): personal or
setup-wide defaults — preferred language, review style, local conventions.<repo>/AGENTS.md): repository rules shared with the team —
architecture boundaries, logging, testing, commit/MR policy. Create or update
it with ZCode's built-in /init (it targets the workspace file, never the
user default).nddev-builder-orientation). AGENTS.md is
instructions only.~/.zcode/AGENTS.md after install).