DSH skills 目录与文件指南

DSH skills 是从约定位置发现的指令资源，因此目录位置、命名和可审查内容比隐藏自动化更重要。

使用工具链支持的 DSH skills 位置

把项目里的 DSH skills 放在当前工具链约定的位置，例如包含 SKILL.md 的命名目录或受支持的 Markdown 文件。

说明适用时机、输入、工具安全边界、输出格式和失败条件，不嵌入凭据或可执行下载。

来源用于核对当前事实，不代表来源方认可本站结论。

DSH skills 是什么？

是一批指令文件，当它们描述的条件和你当下做的事对上时，harness 会加载进来，这样重复性任务不必每次重讲一遍。因为是内容而不是代码，它们可以像普通文件一样在 PR 里被 review。

DSH skills 文件放在哪？

放在工具链会扫描的位置，通常是一个包含 SKILL.md 的具名目录。放错目录的 skill 只是永远不会被发现，而且不会有任何报错提醒你。

我的 DSH skills 为什么从来不触发？

基本都是触发条件写得太虚。要写清具体的场景、命令和用户会说的原话，而不是抽象描述这个 skill 是做什么的。

DSH skills 该放仓库还是放个人配置里？

项目层面的约定放仓库，评审时别人看得到；个人快捷用法放自己的配置。这条线守住，才不会让某个人的习惯悄悄变成团队规则。

DSH skills 文件里能放密钥或者下载步骤吗？

不应该。DSH skills 文件会被随意阅读、复制和分享，而从外部拉进来的内容必须当成不可信输入，不能当成要照做的指令。