跳到主要内容

解决方案指南 · 团队规范

自定义命令与 Skills 的团队落地指南

通过命令文件和技能系统,把“口口相传的经验”变成“可执行的团队资产”。

方法 1

先梳理高频重复场景

把每天都会出现的任务先列出来,例如 /review、/release-check、/doc。只有高频动作才值得抽象成命令或技能。

方法 2

命令负责入口,Skill 负责流程

自定义命令适合做短任务入口;Skill 适合承载完整流程、规则和输出格式。两者配合可以兼顾易用性与可维护性。

方法 3

明确全局与项目级优先级

通用规则放 ~/.hajimi/commands 和 ~/.hajimi/skills;项目差异放 .hajimi/ 下。项目级覆盖全局,避免多仓库互相污染。

方法 4

给命令资产做版本管理

把命令文件和 SKILL.md 纳入 Git,评审变更并记录发布说明。这样每次规范调整都可追踪、可回滚。

方法 5

新成员入组先跑一遍标准命令

在 onboarding 文档中要求新成员执行一组标准命令,确保输出格式、评审维度和团队预期保持一致。

推荐目录结构

~/.hajimi/commands/review.md
~/.hajimi/skills/team-review/SKILL.md

<repo>/.hajimi/commands/release-check.md
<repo>/.hajimi/skills/domain-quality/SKILL.md
  • 命令文件尽量短,聚焦触发场景与输入占位符。
  • Skill 文档写清步骤、边界条件和异常处理方式。
  • 每次规范变更都附带一个真实案例,方便团队对齐认知。