cven-skills
项目摘要
cven-skills 是可公开分发的 Agent Skills 仓库。仓库使用统一的 skills/<skill-name>/ 目录结构，使每个技能能够被兼容工具发现、单独复制和独立安装。首个技能 fable-concept-explainer 用寓言解释抽象概念，并通过概念拆解与问题验证理解结果。
作者职责
- 定义技能目标、触发场景、输入边界和固定输出结构。
- 编写
SKILL.md、许可证、工具元数据和安装文档。 - 核对 Codex 与 CC Switch 等工具的目录兼容方式。
- 使用不同抽象概念检查故事、映射和验证问题的稳定性。
仓库结构
每个技能拥有独立目录，必需入口为 SKILL.md，可选元数据位于 agents/openai.yaml。技能目录包含自己的许可证，因此可以脱离仓库根目录单独分发。根目录只负责索引、安装说明和通用许可证，不把多个技能写入单一超长提示文件。
关键设计决策
- 触发条件描述用户任务，不绑定某个固定措辞，减少漏触发和无关触发。
- 输出顺序固定为寓言、概念解析、元素映射和两个验证问题，便于人工检查完整性。
- 故事保持简洁，概念定义与故事解释分离，避免隐喻替代准确说明。
- 每个技能可独立安装，避免使用者必须复制整个个人配置仓库。
工程难点
寓言需要保留概念关系，又不能直接把术语机械替换为角色。技能通过先约束核心机制、再构造冲突和结果，最后显式映射故事元素，降低故事好读但概念不准确的风险。
验证证据
- 目录包含完整
SKILL.md、许可证和工具元数据。 - 安装文档覆盖技能安装器、仓库扫描和手动复制三种方式。
- 输出契约要求两个定向问题，用于检查读者是否理解关键机制。
已知限制
- 技能输出质量仍取决于模型对目标概念的基础理解。
- 寓言适合建立直觉，不能替代专业领域中的正式定义、数据或操作规范。
- 当前仓库只包含首个公开技能，兼容性范围仍需要更多技能验证。
后续演进
后续可增加技能测试样例、版本兼容说明和更多可独立分发的通用技能，同时保持每个技能职责单一。