Skill Engineering v1.1.0 — Native Authoring

Skill Engineering v1.1.0 — Native Authoring

v1.1.0 把完整 Skill 创建能力收进 Skill Engineering 自身。普通用户只安装
Skill Engineering，即可从模糊需求开始，通过逐步澄清、完整候选生成、写入预览、
明确批准、内容门禁、创建评审和创建后自测完成一个可维护的 Skill；核心创建不再
依赖官方 skill-creator、Superpowers、宿主专用作者 Skill 或独立 Python CLI。

主要变化

• Native Authoring Kernel 与十四字段 Authoring Brief；
• Content Completion Gate，阻断占位内容、空资源、断链和通用 fallback；
• native_plan.py preview → apply → verify 不可变写入计划；
• 创建评审、六态用户可见状态机和 portable self-test；
• Codex、Claude Code、Hermes、Pi、Kimi CLI 宿主适配契约；
• legacy create CLI 仅保留为 scaffold_only 兼容入口。

发布证据

• Codex 无 Creator 真实 E2E 通过；
• K3 remediation 终审 approved；
• Alibaba Skill Up + 真实 Codex 四个核心场景 4/4；
• 212 项 pytest、Ruff、Skill validation、production Doctor 100/A、
  portable self-test、credential lint、release consistency 与 diff check 全绿；
• wheel/sdist 构建及干净虚拟环境安装 smoke 通过。

已知验证边界

正式 Tag 的远程安装、普通用户从模糊需求创建全新 Skill、真实任务试用、失败修复
和维护回归，将在发布后独立项目中执行。在该报告完成前，本项目不宣称已经覆盖
所有新手路径、Agent 宿主和生产环境。Doctor 100/A 表示结构准备度，不等于
业务效用。

完整变化见仓库 CHANGELOG.md 与
docs/testing/2026-08-01-v1.1-release-decision.md。

附件校验

• skill_engineering-1.1.0-py3-none-any.whl
  • SHA-256: 1369ccbc9aa3e9ab03cfd117ea054bc9a31e2a3b6add9b74b9f9790eb8845606
• skill_engineering-1.1.0.tar.gz
  • SHA-256: d6b1a514eb941dfcb0885f83149e6c88523c3262a04344cd5f7bd0fabcbe641d

Skill Engineering v1.0.0 — Stable Lifecycle Contract

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

Skill Engineering v0.1.0 Public Beta

Skill Engineering v0.1.0 Public Beta

首个可供小范围用户使用的 local-first、provider-neutral 开源版本。

核心价值

快速生成从第一版开始就符合工程规范的 Agent Skill，并在每次维护、评测、演进和发布后持续保护架构、边界与质量。

主要能力

• 先自查已有能力、逐步澄清真实任务，再判断是否需要 Skill；
• 比较 Skill、Script、Plugin/runtime、项目规则和复用已有能力等方案；
• 按 atomic、orchestrator、router、adapter、composite 选择最小合理架构；
• 创建采用不可变 Preview → same-plan Apply → postflight，结构失败自动清理；
• production Skill 区分结构完成与真实行为证据完成，不制造假发布结论；
• 维护采用独立候选、复杂度检查、回归证据、写后验证、历史和安全撤销；
• 支持 baseline、holdout、high-risk、negative-transfer 评测和证据驱动自进化；
• 为复杂、商业和多版本 Skill 提供渐进式 Product、Spec/Plan、ADR、Sprint 和版本治理；
• 普通用户默认只看到结果、实际影响和唯一下一步。

验证

• 99 项 pytest 测试通过；
• Python 3.10 与 3.12 GitHub Actions 通过；
• Ruff、production Doctor、官方 Skill 校验、凭证扫描和 diff 检查通过；
• production Doctor：100/A，0 FAIL，0 WARN；
• 创建 Preview → same-plan Apply → postflight E2E 通过；
• 真实 Skill maintenance plan → Apply → verify 通过，可安全撤销。

Public Beta 边界

• Doctor 分数只代表结构 readiness，不代表未测量的跨模型真实业务效用；
• 暂不包含内置模型 provider runner、云端协作、企业 RBAC 或自动 Global 发布；
• 多项目/Profile/Adapter 分发继续由 Agent Skill Hub 负责。

构建产物 SHA-256

• skill_engineering-0.1.0.tar.gz: baf1ffca827241b62b6e6bfbb1b2bb0966f5bc226c2403146e7a717e386a1b2e
• skill_engineering-0.1.0-py3-none-any.whl: 2c84eb0a59ed964f454e8e861ebb721dc68716817dfd31266b274594ead86457