메뉴
Write optional usage_examples.md for an open_supports support package when a library has meaningful post-install workflows. Use after repo summary, install script, and setup Skill are complete.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Fix npm global install failures for @openai/codex when ENOTEMPTY rename conflicts occur in the global node_modules path.
Write skill_for_setup/SKILL.md and skill_for_setup/README.md for any open-source library in the open_supports/ system. Use after scripts_for_install/ is complete. Implements the script-first pattern: primary path runs the install script; fallback follows repo_readme_summary.md Part 2.
Use when creating or updating an open_supports support package end-to-end, especially when coordinating repo summary, install script, setup skill, clarification, resume, or optional install verification.
帮助用户安装并配置 OpenSpec。主路径：运行支持包内的一键脚本；脚本不可用时回退到 repo_readme_summary.md 第 2 部分。范围：安装/更新 CLI、验证版本、可选初始化或更新项目；不含卸载、删除生成文件或详细使用教程。
Write scripts_for_install/install.sh for any open-source library in the open_supports/ system. Use when adding a new support package that needs a one-click installation script. Produces a POSIX sh script with platform detection, flag-driven interface, and idempotent behavior.
Write repo_readme_summary.md for any open-source library in the open_supports/ system. Use when adding a new support package or updating an existing summary. Produces a concise 5-part structured document distilled from the official README.
| name | ost-usage-examples |
| description | Write optional usage_examples.md for an open_supports support package when a library has meaningful post-install workflows. Use after repo summary, install script, and setup Skill are complete. |
| argument-hint | GitHub owner/repo of the target library, e.g. colbymchenry/codegraph |
skill_for_setup 完成后检测到该库有足够复杂的安装后用法，并且用户同意生成详细用例.ost-refs/ 提供了多个实际用法场景，需要整理为本地快速入口本 Skill 是可选阶段。没有 usage_examples.md 不影响支持包核心完成。
执行前读取以下内容，按优先级顺序：
repo_readme_summary.mdskill_for_setup/README.mdskill_for_setup/ost_*_install/SKILL.mdscripts_for_install/install.*.ost-refs/ 目录（如存在且有内容）repo_readme_summary.md 中引用的官方 README / 官方文档链接（仅在需要确认用法时读取）读取 GitHub 仓库事实、README、目录、release、issue、PR 或文件内容时，优先使用 GitHub connector / GitHub app 的结构化工具；若工具不可见，先通过 tool_search 搜索 GitHub 工具。仍不可用时，再考虑 gh CLI、GitHub 官方 API 或官方文档网站。
curl / raw GitHub URL 只用于官方安装命令本身，或作为明确记录的 fallback。生成使用示例时，不要用 raw README 抓取替代 GitHub connector / 官方文档入口；如必须降级，记录原因。
作为 workflow 阶段子代理返回结果时，必须包含：
sources_used: 来源类别和关键路径摘要fallbacks: 降级原因摘要；没有降级时返回空数组如果执行本阶段所需信息无法从 repo_readme_summary.md、安装脚本、setup Skill、.ost-refs/ 或官方文档中可靠判断：
stage: optional_usage_examplesreasonquestionsuggested_default（如有）典型阻塞点：
写入目标支持包根目录：
usage_examples.md
文件头格式：
# {LibraryName} — 使用示例
> 来源：官方 README / 文档；本文件只保留 open_supports 使用者最常见的入口。
按以下顺序编写：
| # | 部分标题 | 内容定位 |
|---|---|---|
| 1 | 快速开始 | 安装完成后的第一条可执行路径，不重复安装步骤 |
| 2 | 常见场景 | 2~5 个高频任务，每个任务可独立阅读 |
| 3 | 与 Agent 客户端配合 | Claude Code、Codex、MCP、IDE 等接入或日常使用方式；无相关内容则删除本节 |
| 4 | 验证与排错 | 最小验证命令、常见失败现象、可执行处理方式 |
| 5 | 延伸阅读 | 官方文档中更完整的教程或高级配置链接 |
每个示例尽量使用以下结构：
### {场景名称}
适用场景：{什么时候使用}
```sh
{命令或最小配置}
```
预期结果：{成功后应看到什么}
注意事项：{只写会影响执行的限制；没有则删除本行}
.ost-refs/ 追溯来源repo_readme_summary.md 第 2 部分和 scripts_for_install/install.* 为准usage_examples.md.ost-refs/