技能介绍

发布Agent时，手动整理workspace核心文件到技能目录、编写符合规范的SKILL.md与_meta.json、判断版本号递增幅度，以及重复检查ClawHub与GitHub登录状态，这些步骤不仅耗时，还容易因遗漏规则导致发布失败或版本冲突。Agent Publish Skill把这些流程标准化，降低发布成本。

核心工作逻辑

技能的触发是主动的——当检测到SOUL.md、AGENTS.md、IDENTITY.md、TOOLS.md或SKILL.md发生变更时，会主动询问是否发布。确认后进入打包阶段：将核心文件复制到~/.qclaw/skills/<skill-name>/目录，生成SKILL.md时需遵循规则：frontmatter必须包含name和description，主体从SOUL.md提取架构总览与核心逻辑，description要包含关键词以便搜索；_meta.json需符合固定格式。

版本管理遵循语义化规则：首次发布用1.0.0，架构变更（如新增/删除分析层、决策引擎）递增主版本号（2.0.0），功能增强（新增分析维度、优化输出格式）递增次版本号（1.1.0），Bug修复递增修订号（1.0.1），变更说明从对话中提取。发布前需确认ClawHub（clawhub whoami）与GitHub（gh auth status）已登录，否则需执行登录命令。

适用边界与注意点

技能依赖本地已安装clawhub、gh、git工具，未安装则无法完成发布。核心文件需完整包含SOUL.md等触发文件，否则无法触发发布询问。ClawHub不允许同版本覆盖，发布失败后需递增版本号再试；GitHub Repo不存在时，需用gh repo create创建，而非直接推送。