用途:为 Codex 或 Claude Code 编写受治理的 Arch Studio 技能。优先使用宿主原生技能制作器,若不存在则按该宿主支持的格式写最小技能。宿主负责通用编写技巧,本技能提供 Arch Studio 的目标、治理与验收要求;不要求特定宿主制作器,也不安装 Arch Studio 运行时。
目标解析:写入前先确定确切目标。目录检测优先级最高:找到 Git 根,检查 .codex-plugin/plugin.json 或 .claude-plugin/plugin.json 是否命名为 as;插件缓存或 MCP 资源不是可写源码检出。否则找最近的 STUDIO.md 作为普通公司技能;仅当用户明确要求仅项目技能时才用最近项目根。若未确定根,只问一个目标问题。全局目标需显式请求。
目录:已验证目录检出为 {project-root}/skills/{name}/;工作室为 {studio-root}/{host-skill-root}/{name}/;仅项目为 {project-root}/{host-skill-root}/{name}/;全局为 {host-global-skill-root}/{name}/。Codex 用 .agents/skills,Claude Code 用 .claude/skills;全局根分别为 $HOME/.agents/skills 与 $HOME/.claude/skills。宿主不明确时询问。
治理:读取完整工作室策略契约;生成步骤应在每次调用及恢复依赖策略的动作前重新解析当前工作室并重读中央策略,处理不可读引用与冲突,保留既有授权。Skill Maker 从不写 STUDIO.md 或采纳策略。独立/全局技能不需要工作室。公开目录输出不得含来源策略文本、私有定位符或工作室身份。
编写:创建 SKILL.md 与简短 README.md;目录名用 kebab-case 并与 name 匹配;仅在选择宿主支持且需要时加 allowed-tools;不得嵌入 ~/ 路径。涉及代码、分区或生命安全分析时保留规范免责声明与 <!-- architecture-studio:requires-disclaimer --> 标记。
校验:运行宿主制作器检查,并独立应用 skill_scaffold.validate 语义:目录为 kebab-case;README.md 与 UTF-8 SKILL.md 可读;SKILL.md 以带分隔的 YAML frontmatter 开头,其安全解析映射含匹配 name 与非空 description;任何位置不得出现 ~/。成功需实际目标读回后报告 {"valid": true, "directory": "<actual input path>", "name": "<directory name>"}。结构检查不证明可发现性、策略访问或实用性。