Code at the speed of thought – Zed is a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.
docs: Update information regarding rules/skills (#57824)
Danilo Leala9296b9a5ac2
diff --git a/docs/src/ai/rules.md b/docs/src/ai/rules.mdindex 9258be157e6..87f6008ce67 100644--- a/docs/src/ai/rules.md+++ b/docs/src/ai/rules.md@@ -72,9 +72,10 @@ You can set any rule as the default by clicking the paper clip icon button in th## Migrating to Skills {#migrating-to-skills}-When you update to Zed v1.4.0, your existing Rules are migrated to Skills automatically:+As of Zed v1.4.0, your existing Rules are migrated to Skills automatically:- **Non-default Rules** become global skills in `~/.agents/skills/`, each with `disable-model-invocation: true`. They remain user-invocable via `/skill-name` or `@`-mention.- **Default Rules** are appended to your global `AGENTS.md` file (`~/.config/zed/AGENTS.md` on macOS and Linux, `%APPDATA%\Zed\AGENTS.md` on Windows), preserving their behavior of being included in every conversation.+- **Git Commit** prompt customizations are also appended to the global `AGENTS.md` file.-A banner in the title bar announces the migration when it runs. Your original Rule data is not deleted, so downgrading to an earlier version of Zed leaves your Rules intact.+Lastly, note that all of the content you had available in the Rules Library hasn't been deleted, so downgrading to an earlier version of Zed leaves your Rules intact.diff --git a/docs/src/git.md b/docs/src/git.mdindex c2e19e3d88d..0d0fcc1a4e8 100644--- a/docs/src/git.md+++ b/docs/src/git.md@@ -272,12 +272,12 @@ To view a stash's contents, select it in the stash picker and press {#kb stash_p## AI Support in GitZed currently supports LLM-powered commit message generation.-You can ask AI to generate a commit message by focusing on the message editor within the Git Panel and either clicking on the pencil icon in the bottom left, or reaching for the {#action git::GenerateCommitMessage} ({#kb git::GenerateCommitMessage}) keybinding.+You can ask AI to generate a commit message by focusing on the message editor within the Git Panel and either clicking on the pencil icon in the bottom left, or reaching for the {#action git::GenerateCommitMessage}, or through the {#kb git::GenerateCommitMessage} keybinding.> Note that you need to have an LLM provider configured either via your own API keys or through Zed's hosted AI models.> Visit [the AI configuration page](./ai/configuration.md) to learn how to do so.-You can specify your preferred model to use by providing a `commit_message_model` agent setting.+You can specify your preferred model for this task by adding a `commit_message_model` field to your agent settings.See [Feature-specific models](./ai/agent-settings.md#feature-specific-models) for more information.```json [settings]@@ -285,18 +285,16 @@ See [Feature-specific models](./ai/agent-settings.md#feature-specific-models) fo"agent": {"commit_message_model": {"provider": "anthropic",- "model": "claude-3-5-haiku"+ "model": "claude-4-5-haiku"}}}```-To customize the format of generated commit messages, run {#action agent::OpenRulesLibrary} and select the "Commit message" rule on the left side.-From there, you can modify the prompt to match your desired format.+To add custom commit instructions for the model, use the global `AGENTS.md` file located `~/.config/zed/AGENTS.md` on macOS and Linux, `%APPDATA%\Zed\AGENTS.md` on Windows.-<!-- Add media -->--Any specific instructions for commit messages added to [Rules files](./ai/rules.md) are also picked up by the model tasked with writing your commit message.+> Before Zed v1.4.0, this was done through the Rules Library, which has been removed.+> See [the "Migrating to Skills" docs](./ai/rules.md#migrating-to-skills) in the Rules page for more information.## Git Integrations