Skip to content

Skill Engineering v1.0.0 — Stable Lifecycle Contract

Choose a tag to compare

@wukongai wukongai released this 18 Jul 01:18
· 9 commits to main since this release

Skill Engineering v1.0.0

首个稳定生命周期版本:帮助用户从第一版开始创建结构清晰的 Agent Skill,并在检查、维护、评测、演进和发布过程中持续守住架构与安全边界。

主要内容

  • 用户可见名称完全统一为 skill-engineering,不再暴露 skill-guide
  • 普通用户通过标准 skills CLI 直接安装,不需要克隆源码。
  • 创建与维护遵守 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 -y

Claude 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 team

Agent 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 稳定契约中。