Back to Details

custom-skills-dev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

custom-skills-dev

custom-skills-dev

ai-dev 的 framework 與第一方 skills 分成兩個公開 repositories。開始前先確認目標，不要把內容改到錯的 repository。
ai-dev 的 framework 与第一方 skills 分为两个公开 repositories。开始前先确认目标，不要把内容改到错误的 repository。

Repository ownership

Repository ownership

Repository負責內容
ValorVie/custom-skills
ai-dev CLI、commands、agents、plugins、project-template、OpenSpec、upstream 設定與 
upstream/npx-skills.yaml
ValorVie/ai-dev-skills
npx skills
可安裝的第一方 
skills/<canonical-id>/
、skill 直接測試及 collection validator
第一方 skill 內容不得複製回 framework repository。ai-dev baseline 是否採用某個 skill，由 framework 的 
upstream/npx-skills.yaml
明確決定。
Repository负责内容
ValorVie/custom-skills
ai-dev CLI、commands、agents、plugins、project-template、OpenSpec、upstream 设置与 
upstream/npx-skills.yaml
ValorVie/ai-dev-skills
npx skills
可安装的第一方 
skills/<canonical-id>/
、skill 直接测试及 collection validator
第一方 skill 内容不得复制回 framework repository。ai-dev baseline 是否采用某个 skill，由 framework 的 
upstream/npx-skills.yaml
明确决定。

Runtime flow

Runtime flow

text
ai-dev install
  tools → repos → npx-skills → targets

ai-dev update
  tools → repos → npx-skills
  • npx-skills
    安裝或更新第一方與第三方 global skills。
  • targets
    只分發仍由 framework 管理的 commands、agents、workflows、plugins，以及明確保留 clone ownership 的來源。
  • ECC 白名單 skills 與 custom repo skills 仍可由 clone 管理；不得與 npx-managed canonical ID 同名。
完整 ownership 與路徑見 copy-architecture.md。
text
ai-dev install
  tools → repos → npx-skills → targets

ai-dev update
  tools → repos → npx-skills
  • npx-skills
    安装或更新第一方与第三方 global skills。
  • targets
    只分发仍由 framework 管理的 commands、agents、workflows、plugins，以及明确保留 clone ownership 的来源。
  • ECC 白名单 skills 与 custom repo skills 仍可由 clone 管理；不得与 npx-managed canonical ID 同名。
完整 ownership 与路径见 copy-architecture.md。

修改 ai-dev framework

修改 ai-dev framework

  1. 在 
    ValorVie/custom-skills
    checkout 確認現有 dirty files 與 active OpenSpec change。
  2. 修改 
    script/
    、
    commands/
    、
    agents/
    、
    plugins/
    、
    project-template/
    或 
    upstream/
    中的必要檔案。
  3. 為使用者可見行為更新 OpenSpec delta、測試與正式文件。
  4. 使用目前 checkout 執行測試，不使用可能過時的已安裝 
    ai-dev
    。
  5. framework release 只提交 framework 範圍，不夾帶另一個 repository 的 skill content。
新增 CLI command 的細節見 cli-development.md。
  1. 在 
    ValorVie/custom-skills
    检出代码，确认现有未提交文件与活跃的 OpenSpec 变更。
  2. 修改 
    script/
    、
    commands/
    、
    agents/
    、
    plugins/
    、
    project-template/
    或 
    upstream/
    中的必要文件。
  3. 为用户可见行为更新 OpenSpec delta、测试与正式文档。
  4. 使用当前检出的代码执行测试，不使用可能过时的已安装 
    ai-dev
    。
  5. framework 发布仅提交 framework 范围内的内容，不得夹带另一个 repository 的 skill 内容。
新增 CLI command 的细节见 cli-development.md。

新增或修改第一方 skill

新增或修改第一方 skill

  1. 在 
    ValorVie/ai-dev-skills
    的 
    skills/<canonical-id>/
    修改內容。
  2. 目錄名必須與 
    SKILL.md
    frontmatter 
    name
    相同。
  3. 主要流程需要的 scripts、references、assets、templates、evals 與直接測試必須留在 skill root 內。
  4. 執行 repository validator、skill 直接測試及 npx discovery：
bash
python tests/validate_skills.py
DISABLE_TELEMETRY=1 npx --yes skills@1.5.22 add . --list
  1. 新 skill 只有在 ai-dev 維護者更新 
    upstream/npx-skills.yaml
    後，才會進入 baseline。不得用 wildcard 自動採用。
  1. 在 
    ValorVie/ai-dev-skills
    的 
    skills/<canonical-id>/
    修改内容。
  2. 目录名必须与 
    SKILL.md
    前置元数据 
    name
    相同。
  3. 主要流程所需的 scripts、references、assets、templates、evals 与直接测试必须留在 skill 根目录内。
  4. 执行仓库验证器、skill 直接测试及 npx 发现：
bash
python tests/validate_skills.py
DISABLE_TELEMETRY=1 npx --yes skills@1.5.22 add . --list
  1. 新 skill 只有在 ai-dev 维护者更新 
    upstream/npx-skills.yaml
    后，才会进入 baseline。不得使用通配符自动采用。

修改 npx baseline

修改 npx baseline

在 
ValorVie/custom-skills
：
  1. 先用 
    npx skills add <repo> --list
    確認來源與 canonical IDs。
  2. 檢查同名來源、agent paths 與現有 local modifications。
  3. 在 
    upstream/npx-skills.yaml
    明確加入 repository 與 skill names。
  4. 更新 npx manifest、install/update、list、toggle 與 migration 測試。
  5. dry-run 不得執行 npx、寫 lock 或清理 ownership。
在 
ValorVie/custom-skills
：
  1. 先用 
    npx skills add <repo> --list
    确认来源与 canonical IDs。
  2. 检查同名来源、agent paths 与现有本地修改。
  3. 在 
    upstream/npx-skills.yaml
    明确加入 repository 与 skill names。
  4. 更新 npx 清单、install/update、list、toggle 与迁移测试。
  5. 试运行（dry-run）不得执行 npx、写入锁文件或清理 ownership。

發布

发布

兩個 repositories 分開發布、分開驗證、分開 commit。
ai-dev-skills
應先有可讀取的 known-good revision，ai-dev 才能引用它。
任何 repository creation、release、tag 或 push 都要遵循當前專案授權；一般文件或程式修改不自動授權 remote mutation。
framework release 細節見 release-workflow.md。
两个 repositories 分开发布、分开验证、分开提交。
ai-dev-skills
应先有可读取的已知稳定版本，ai-dev 才能引用它。
任何仓库创建、发布、标签或推送都要遵循当前项目授权；一般文件或程序修改不会自动授权远程变更。
framework 发布细节见 release-workflow.md。

Language

语言规范

  • 人類文件使用繁體中文，技術識別字保留原文。
  • Commit message 使用 Conventional Commits 與繁體中文摘要。
  • 公開內容不得包含內部品牌、repository、host、帳號、credential 位置、private path 或組織專用流程。
  • 人工文档使用简体中文，技术标识符保留原文。
  • Commit message 使用 Conventional Commits 与简体中文摘要。
  • 公开内容不得包含内部品牌、repository、主机、账号、凭证位置、私有路径或组织专用流程。