vndangkhoa/zed
1
0
Fork 0
mirror of https://github.com/zed-industries/zed.git synced 2026-06-01 03:14:56 +07:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

docs: Update information regarding rules/skills (#57824) (cherry-pick to preview) (#57826)

Browse source 
Cherry-pick of #57824 to preview

----
Update some content regarding the skills migration and its impact on the
Git commit prompt.

Release Notes:

- N/A

---------

Co-authored-by: Bennet Bo Fenner <bennetbo@gmx.de>

Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Co-authored-by: Bennet Bo Fenner <bennetbo@gmx.de>
This commit is contained in:
zed-zippy[bot] 2026-05-27 13:45:05 +00:00 committed by GitHub
parent 2175af2b33
commit 4d0cde92a6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 9 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
docs/src/ai/rules.md
View file

@ -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.

14
docs/src/git.md
View file

@ -272,12 +272,12 @@ To view a stash's contents, select it in the stash picker and press {#kb stash_p
## AI Support in Git
Zed 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