扁平演示

要解决的问题

把 Agent Skills 接入分发渠道时，最先撞上的工程问题往往不是「这个技能能做什么」，而是「一条技能从仓库到运行时，链路是否完整」。打包脚本有没有漏掉 SKILL.md，清单字段能不能被正确解析，安装提示词引用的 slug 是否对得上，这些都需要先有一个最小可用的技能做端到端验证。拿真实功能技能当测试夹具反而不合适：它的输出会被实际逻辑干扰，你很难判断一次失败到底是被测链路的问题，还是技能自身的行为。

技能的工作方式

flat-demo 就是为这个目的存在的占位技能：

• 扁平结构：没有嵌套子模块，没有 utils/ 之类的辅助目录，也没有可选扩展，全部内容集中在 SKILL.md 这一个入口；
• 单一入口：正文只有一行占位内容 Test body.，渲染之后就是整个技能的完整输出，没有隐藏逻辑；
• 零依赖：不涉及网络请求、凭证或特定运行环境，任何支持 Markdown 渲染的宿主都能直接消费它。

适用边界与注意点

• 它不提供任何实际功能，只是一份演示样例，不要把它当作可投产的技能来评估；
• 正文没有声明触发条件，也没有示例输入输出，无法据此推断真实的调用方式；
• 接入过程中遇到解析失败时可以拿它做对照组，但要排除自己后续修改引入的变量；
• 校验清单时逐项核对名称、来源与正文的对应关系，而不是凭渲染结果倒推配置是否正确。