Skill Engineering v1.0.0 — Stable Lifecycle Contract
Skill Engineering v1.0.0
首个稳定生命周期版本:帮助用户从第一版开始创建结构清晰的 Agent Skill,并在检查、维护、评测、演进和发布过程中持续守住架构与安全边界。
主要内容
- 用户可见名称完全统一为
skill-engineering,不再暴露skill-guide。 - 普通用户通过标准
skillsCLI 直接安装,不需要克隆源码。 - 创建与维护遵守 Preview → 明确确认 → 同一未漂移计划 Apply → 验证。
- 提供 lint、Doctor、行为评测、维护/撤销、自进化与受控发布能力。
- Agent Skill-only 环境缺少 Python CLI 时会给出明确安装指引,不再输出不可读的 traceback。
- 采用 Apache License 2.0,包含 NOTICE、引用元数据和品牌使用边界。
安装 Agent Skill
Codex:
npx skills add wukongai/skill-engineering --skill skill-engineering -g -a codex -yClaude Code 将 -a codex 替换为 -a claude-code;只在当前项目使用时去掉 -g。
安装确定性 Python CLI
uv tool install "git+https://github.com/wukongai/skill-engineering.git@v1.0.0"
skill-engineering doctor ./your-skill --profile teamAgent Skill 与 Python CLI 是两个独立入口:前者负责对话式创建和维护,后者负责可重复执行的确定性检查。
验证结果
- 远程安装 → 用户澄清 → 预览 → 确认创建 → 缺陷反馈 → 根因修改 → Doctor 黄金链路通过。
- pytest:133 passed。
- Ruff、官方 Skill validation、credential lint、diff check:passed。
- production Doctor:0 FAIL / 0 WARN,100/A(结构准备度,不等于跨模型真实效用)。
- Python 3.10、3.12、3.14 支持矩阵与干净环境安装 smoke 已验证。
2.0 Architecture Guardian 仍属于开发预览,不包含在本次 1.0 稳定契约中。