用途:以当前 Git 仓库为中心,把仓库技能目录与相关用户已安装技能作为一个组合进行清点与协调,判断哪些关系存在缺陷、哪些属于需判断的改动、哪些应保持原样。
必要用法:要求 PATH 中存在 ai-skillet 0.1.0 或更新版本,否则停止并提示安装或升级;要求 PATH 中存在 git,用 git rev-parse --show-toplevel 解析当前仓库,不读取 Git 历史。Git 缺失时提示“skill-harmonization: Git is required and was not found on PATH.”;解析失败时提示“skill-harmonization: run from inside a Git repository.”。清点命令为:ai-skillet map --portfolio-root <repo-root> --format json,需为合法 JSON;必要时可对仓库与用户技能根运行 ai-skillet doctor --format json 作为补充证据。
主要能力与模式:按任务权限决定行为。检查、审计、评审、诊断或无写入意图的调用只做调查评估,不编辑;规划请求返回决策完整的计划,不实施;实施请求执行获授权变更并验证、报告。不强制先报告、保存报告或计划审批;仅当未决选择影响范围、安全或预期结果时才询问。对重命名、删除、破坏性操作及来源归属不明的全局技能,保留确认边界。
证据与分类:只使用静态仓库证据,如 SKILL.md、技能内脚本、引用、agents 元数据、示例与资产,以及适用的 AGENTS.md、CLAUDE.md、仓库面对文档和引用的自动化命令;不检查对话记录、Git 历史、TODO、缓存、智能体状态或无关源码,也不把缺少引用当作未使用的证据。每个发现需给出词法与解析路径(不同时)、适用客户端及机械或文本证据。关系分类包括经证实缺陷、需判断候选、有意保持不改。外部管理的用户安装若文档或安装自动化指明上游来源且清单能为受影响客户端解析,视为有效的有意不改。
限制:写入前须先确定技能的规范来源(仓库说明、符号链接目标、生成或发布自动化、源/安装哈希),只改规范目录或生成器输入并运行归属工作流,不手改已发布的全局副本;无来源归属的全局副本按归属未知处理,实施前须停下确认。实施时保留无关工作、遵循仓库协调与提交规则,运行最窄范围的技能检查,必要时重跑清单验证。资料未提供收费或平台等信息。