z-index(技能目录 · 发现层)
一句话:z-系列的目录与解释器——扫本机、分类列示、忠实描述,帮人(和模型)看见"有什么、是什么、流程怎么走"。
help 用法卡
调用消息或斜杠参数恰为 help / 帮助 / 怎么用(整条仅此一词)时,逐字输出本卡后停,不进入任何流程;请求含其他内容时按正常流程走。
【z-index 用法卡】技能目录——扫本机技能、分类解释、流程呈现。
| 场景 | 你这样说 | 会发生什么 |
|---|---|---|
| 全目录 | 「有哪些 z 技能」「技能目录」 | 分类列示:单体×5 + 流程×1 + 发现×1 + 其他本地技能 |
| 找工具 | 「我想做 X,用哪个技能」 | 按意图指路到对应单体或流程技能 |
| 看流程 | 「z-flow-kickoff 的流程是什么样」 | 流程图呈现与逐步解释 |
本系列全景问法(整链/组合/元命令)见 z-flow-kickoff help。
开场协议(轻量级,z-系列工作模式)
查询前一句话复述并入首条回复(将扫哪里、输出什么),不单独占一轮;纯单问(如"z-assess 是干嘛的")直接答,不跑全扫描。被 z-flow-kickoff 编排进入时沿用其契约与横幅。
扫描范围(如实声明,永远输出)
~/.zcode/skills/(用户级安装位)——必扫。<当前项目>/.zcode/skills/(项目级)——存在才扫,并注明"项目级"。- 不在范围:宿主内置技能、插件技能(plugin cache 目录,随插件版本移动)——输出时明确注明"未含插件与内置技能",不装全知。
工作方式
- 列目录下各子目录,读其
SKILL.mdfrontmatter(name / version / archetype / category / description)。frontmatter 缺失或不可读的,只列目录名并标"未读到描述",不猜测。 - 分类呈现(z-系列):
- 单体技能(archetype: unit):名称、版本、一句话定位(截自 description 首句)、典型问法一行(引其 help 卡首行;help 命令名一并给出,如/z-clarify-help)。
- 流程技能(archetype: flow):同上,另附流程图与逐步解释——从其 SKILL.md"与 z-系列的关系"节原样呈现关系图并解释各站衔接(注明出处,不另行绘制,单一事实源);有原子流程目录的(如 z-flow-kickoff),逐条列出流程名、站点序列与触发问法(截自其目录表,不改义)。
- 发现技能(archetype: index):本 skill 自身,一行带过。 - 其他本地技能(非 z-系列):集中一节列示——名称 + description 忠实转述(截自 frontmatter,可缩不可改义),并注明"描述截取自各 SKILL.md frontmatter";不加戏、不评价好坏、不推测用法(宁缺勿编铁律,对第三方技能最易失守处)。
- 按意图找工具的查询("我想做 X 用哪个"):按问法公式(对象+意图+边界)匹配到单体或流程技能,给一句问法示例并指路其 help;匹配不唯一时列候选让用户选,不替用户定。
输出骨架
【z-index 技能目录】扫描范围:~/.zcode/skills/(+ 项目级,如有)|未含插件与内置技能
■ 流程技能(z-flow-*,编排不实现)
z-flow-kickoff v1.8 立项启动模式:从想法到文档基线全流程编排
流程图(引其 SKILL.md)+ 各站一句话解释
■ 单体技能(z-*,功能原子,可独立安装)
z-pyramid v1.7 金字塔原理:拆解与结构化表达 /z-pyramid-help
…
■ 发现技能(本目录)
z-index v1.0 技能目录与解释(本 skill)
■ 其他本地技能(忠实转述 frontmatter 描述)
<名> <描述转述>…
与 z-系列的关系
z-index(本 skill:发现层——目录/解释/流程呈现)
↓ 发现
z-flow-kickoff(编排层:开场协议→契约→横幅→交接→续跑)
└─ z-pyramid(拆解) → z-clarify(澄清→登记册) ⇄ z-chain(生态事实)
↓
z-assess(四维+风险+假设 → Go/No-Go)
↓ Go
z-init(工程文档基线化) → 下游 spec/开发(松耦合,AGENTS.md 契约)
三层分工:发现层(本 skill)管"有什么、是什么";编排层(z-flow-)管"按什么顺序串";功能层(单体 z-)管"具体实现"。本 skill 不编排、不实现、不做触发诊断(技能为何没触发属宿主配置问题,归官方诊断工具管)。
边界
- 只发现与解释,不触发、不调用其他技能执行任务(指路即止)。
- 对非本系列技能零评价、零加戏,描述必须可溯源到其 frontmatter。
- 扫不到的如实说扫不到;覆盖范围声明永远是输出的一部分。
- 语言与用户一致。