@bysking/b-code 0.1.5 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +23 -1
  2. package/dist/cli.mjs +241 -239
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -106,7 +106,9 @@ rm -rf / git push / git reset --hard / sudo / mkfs
106
106
 
107
107
  ## 技能(Skills)
108
108
 
109
- 把常用提示词包装成 `/name 参数` 命令。技能文件 = frontmatter + 正文:
109
+ 把常用提示词包装成 `/name 参数` 命令。技能支持两种形态,技能名 = 文件名 / 目录名:
110
+
111
+ **平铺文件** `{name}.md` —— 单文件即技能:
110
112
 
111
113
  ```markdown
112
114
  ---
@@ -118,9 +120,29 @@ user-invocable: true
118
120
  按以下规范提交:$ARGUMENTS
119
121
  ```
120
122
 
123
+ **技能目录** `{name}/SKILL.md` —— 对齐 Claude 生态,目录名即技能名,描述与正文读目录下的 `SKILL.md`(或小写 `skill.md`),目录里的其他文件(reference、模板等)作为技能资源:
124
+
125
+ ```
126
+ .claude/skills/
127
+ ├── commit.md # 平铺形态
128
+ └── changelog-generator/
129
+ ├── SKILL.md # 目录形态:描述 + 正文
130
+ └── templates/ # 技能资源,不参与解析
131
+ ```
132
+
133
+ 两种形态的差异:
134
+
135
+ | | 平铺文件 | 技能目录 |
136
+ |---|---|---|
137
+ | 技能名 | 文件名(去 `.md`) | 目录名 |
138
+ | `user-invocable` | 需显式写 `true` | 默认可调用,写 `false` 关闭 |
139
+ | 同名冲突 | 同目录内平铺优先 | — |
140
+
121
141
  正文里的 `$ARGUMENTS` 会被替换为调用时传入的参数。技能调用优先于普通对话:
122
142
  `/commit 修复登录 bug` → 命中 `commit` 技能并替换参数。
123
143
 
144
+ frontmatter 的 `description` 支持块标量多行写法(`>-` 折叠成一行、`|` 保留换行),与 Claude 生态 SKILL.md 兼容。
145
+
124
146
  **搜索链(越靠前优先级越高,同名技能前者生效):**
125
147
 
126
148
  1. `{cwd}/.claude/skills` —— 项目级