进阶
技能与自定义命令
技能是某类任务的做法说明，模型用得上时自己去读；heng-agent 内置 debugging、writing-tests 等 5 个，也能写自己的。自定义命令把常用提示词存成 /名字，支持 $ARGUMENTS；/commit、/review 可以按团队规矩改写。
- 预计用时
- 约 6 分钟
- 适用版本
- v0.5.0 及以上
看看内置的技能
装好就有、不用配置。模型在任务对得上时自动读它的完整说明再动手，/skills 查看：
| 技能 | 什么时候用 |
|---|---|
| debugging | 报错、测试失败、行为不对：先复现、再定位、找到根因再修，最后加回归测试 |
| writing-tests | 写测试：照项目已有的框架与风格，覆盖正常路径、边界与出错情况 |
| refactoring | 重构：先有测试兜底，小步改、每步都验证，行为不变 |
| codebase-tour | 读懂陌生项目：怎么跑起来、模块怎么分工、关键流程怎么走 |
| security-check | 安全检查：密钥泄露、注入、越权、不安全的输入与依赖，按严重程度报告 |
写一个自己的技能
放在 .heng-agent/skills/<名字>/SKILL.md（项目）或 ~/.heng-agent/skills/<名字>/SKILL.md（所有项目通用），同名时项目的优先：
---
name: test-style
description: 本项目写单元测试的规矩（新增或修改测试前必读）
---
- 每个测试方法第一行写中文 docstring，说明测的是什么
- 边界值至少测「刚好等于」和「差一点」系统提示词里只列名字和 description，模型觉得对得上才读全文，所以装再多也不挤占上下文。description 要写清「什么时候该读它」。技能目录里还可以放模板、清单等文件，模型按需读。
把常用提示词存成命令
存成 .heng-agent/commands/<名字>.md（或 ~/.heng-agent/commands/），输入 /名字 参数 就展开发给模型。正文里的 $ARGUMENTS 换成参数，没写就把参数接在末尾：
给 $ARGUMENTS 补单元测试：沿用 tests/ 里已有的夹具，跑一遍确认通过，最后列出新增了哪些用例。存成 .heng-agent/commands/add-tests.md 后输入 /add-tests src/api/auth.py。脚本模式里 -p "/add-tests src/api/auth.py" 同样可用。
内置命令（/help、/undo……）优先，同名的自定义命令不生效。
改写 /commit 和 /review
/commit [要求]：按仓库风格写提交信息并提交（不 push、不改历史）；/review [关注点]：审查没提交的改动，按严重程度列问题（只评审不修改）。
在 .heng-agent/commands/ 放同名的 commit.md / review.md，就能按自己团队的规矩改写这两个命令。
做完是这样
/skills 里能看到内置的 5 个技能和你写的技能；输入 / 补全时出现你的自定义命令，/add-tests 文件 展开成完整的提示词发给模型。