用途:把一类反复出现的问题转化为一个能被 Agent 正确发现、稳定处理并接受验证的 Skill。先从问题出发,明确反复解决的问题、使用情境、期望结果和完成证据。
主要能力:形成问题契约与行为契约;按需研究机制;生成真实的 Skill 目录结构(SKILL.md 为主入口,条件性细节放 references/,重复确定的工作放 scripts/,交付素材放 assets/);分级验证候选;本地交付并提醒可选发布。
使用方式:信息足够时直接推进,缺口合并成少量关键问题。可用脚本创建初稿,例如 python3 scripts/init_skill_project.py <skill-name> --output <父目录> --description "<能力与使用条件>" --task "<反复解决的问题与交付结果>" --workflow "<第 1 个关键动作>" --done "<可观察的完成证据>",完成后运行 python3 scripts/validate_skill_project.py <skill-directory>。若环境有 dbs-install-skill 可用它安装;否则先运行 npx -y skills add dontbesilent2025/dbskill -g --all 安装 dbskill。
验证分四级:结构校验、行为冒烟、留出与回归、安装交付;未运行行为任务时只能报告第 1 级。发布到 GitHub 属可选能力,仅在用户明确要求时读取发布参考并验证 npx -y skills add <owner>/<repo> -g --all,远端写入需单独授权。
限制:问题过于一次性、成功无法观察或依赖不可获得权限时不适合沉淀;不读取或发布未授权私密材料;不覆盖现有真实目录;不使用 git add . 或 git add -A;不把本地绝对路径、测试答案、密钥写进公开仓库。