Scaffold Skill 是 a-tokyo/aiworkspace 工作区中用于创建新 AI 智能体技能（skill）的脚手架工具。它通过工作区脚本处理技能名称校验、目录放置，并将技能符号链接到所有 AI 工具目录，从而让 Cursor、Claude Code、Codex 等各类 IDE 工具都能发现并使用该技能。
用途
当需要创建新技能、添加本地技能，或希望让某个技能被工作区内多个 AI 工具共享时，可使用 Scaffold Skill。它解决了技能目录分散、各工具发现路径不一致的问题，通过统一的脚本和符号链接机制，确保技能在正确的目录中被所有目标工具识别。
主要能力
- 名称校验：脚本会验证技能名称是否符合命名规则。
- 目录创建：在正确的作用域路径下创建技能目录，并生成模板 SKILL.md。
- 符号链接：自动将技能链接到 .claude/skills/ 和 skills/ 等目录，使每个 AI 工具都能发现它。
- 作用域管理：支持工作区级和项目级两种技能存放方式。
- 列表验证：可通过命令列出已创建的技能，确认其出现在预期位置。
使用方式
1. 确定作用域
若用户未明确说明，需先询问。工作区级技能存放在 root-config/.agents/skills/，并符号链接到工作区根目录，使所有项目和 AI 工具（.agents/skills/、.claude/skills/、skills/）都能发现。项目级技能存放在 <repo>/.agents/skills/，仅符号链接到该项目的 AI 工具目录。
2. 执行脚手架
从 workspace/ 目录运行：
工作区级：
npm run skills:create -- --name <skill-name>
项目级：
npm run skills:create -- --name <skill-name> --project <repo>
该命令会校验名称、创建带模板 SKILL.md 的目录，并运行 setup 将技能符号链接到 .claude/skills/ 和 skills/。
命名规则：仅允许小写字母、数字、连字符、下划线和点号；最长 64 字符；必须以字母或数字开头和结尾。
3. 编写内容
不要直接编写 SKILL.md 内容，而应委托给 IDE 的技能编写指南，以获得高质量内容并正确收集需求。可在可用技能中搜索名为 create-skill 的技能，常见位置包括：
- Cursor：~/.cursor/skills-cursor/create-skill/SKILL.md
- Claude Code：~/.claude/skills-cursor/create-skill/SKILL.md
也可在可用技能列表中查找名称含 "create-skill"，或描述中同时含 "skill" 与 "create" 的技能。
若找到：阅读并从头遵循其完整工作流，包括任何发现或需求收集阶段（向用户询问用途、触发条件、格式等）。以脚手架生成的 SKILL.md 为起点，按指南填写。
若未找到：直接编辑生成的 SKILL.md：将占位描述替换为具体的第三人称描述，同时说明技能做什么（WHAT）和何时使用（WHEN）；将占位正文替换为清晰的指令和示例；保持文件在 500 行以内。
4. 验证
确认技能出现在预期位置：
npm run skills:list
无 shell 访问权限时的回退方案
若无法运行脚本，可在正确的 .agents/skills/ 路径下手动创建技能目录和 SKILL.md，然后请用户运行：
cd workspace && npm run skills:setup
这会重新同步所有符号链接。
适用场景
- 在 aiworkspace 工作区中创建新的 AI 智能体技能。
- 需要让技能被多个 IDE 工具（Cursor、Claude Code、Codex 等）同时发现。
- 需要区分工作区级共享技能与项目专属技能。
- 希望借助 IDE 内置的技能编写指南来规范技能内容。
限制
- 依赖工作区脚本和 npm 命令，需要 shell 访问权限；无权限时需手动创建并请用户运行 setup。
- 技能名称受严格命名规则约束。
- SKILL.md 内容编写建议委托给 create-skill 指南，而非直接编写。
- 文件行数建议控制在 500 行以内。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。