名称: 创建-命令 描述: “创建新技能”
创建新技能
根据用户需求在.agents/skills/<技能名称>/SKILL.md中创建新的Codex技能。
使用方式
$create-command <技能名称> <描述>
示例:
$create-command review-pr 检查PR代码变更是否符合项目指南
执行步骤
1. 解析输入
从用户输入中提取:
- 技能名称: 使用kebab-case(例如
review-pr) - 描述: 技能应实现的功能
2. 分析需求
基于描述确定技能类型:
- 初始化: 阅读文档,建立上下文
- 预开发: 阅读指南,检查依赖
- 代码检查: 验证代码质量和指南合规性
- 记录: 记录进度、问题、结构变更
- 生成: 生成文档或代码模板
3. 生成技能内容
最小SKILL.md结构:
---
名称: <技能名称>
描述: "<描述>"
---
# <技能标题>
<使用此技能的时机和方法的说明>
4. 创建文件
创建:
.agents/skills/<技能名称>/SKILL.md
5. 确认创建
输出结果:
[OK] 创建技能: <技能名称>
文件路径:
- .agents/skills/<技能名称>/SKILL.md
使用方式:
- 直接使用$<技能名称>触发
- 或在/skills中选中它
描述:
<描述>
技能内容指南
[OK] 好的技能内容
- 清晰简洁: 立即可理解
- 可执行: AI可以直接遵循步骤
- 范围明确: 清楚界定做什么和不做什么
- 有输出: 指定期望的输出格式(如果需要)
[X] 避免
- 太模糊: 例如"优化代码"
- 太复杂: 单个技能不应超过100行
- 功能重复: 首先检查是否存在类似技能
命名约定
| 技能类型 | 前缀 | 示例 |
|---|---|---|
| 会话开始 | start |
start |
| 预开发 | before- |
before-frontend-dev |
| 检查 | check- |
check-frontend |
| 记录 | record- |
record-session |
| 生成 | generate- |
generate-api-doc |
| 更新 | update- |
update-changelog |
| 其他 | 动词优先 | review-code, sync-data |