Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/repository-metrics-traffic.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"views_14d": 0,
"unique_cloners_14d": 0,
"clones_14d": 0,
"traffic_as_of": "2026-08-11T00:00:00Z",
"traffic_as_of": "2026-08-11T14:09:50Z",
"clone_series_14d": [
{
"timestamp": "2026-07-29T00:00:00Z",
Expand Down
27 changes: 16 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,24 +39,28 @@ merge, change visibility, or place credentials in documentation.

## Quick start

### 1. Install with Codex's built-in Skill Installer
### 1. Install project-locally

Ask Codex:
```bash
DISABLE_TELEMETRY=1 npx skills add JNHFlow21/open-source-launch \
--skill open-source-launch \
--agent codex \
--yes
```

This verified route installs the Skill into the current project's
`.agents/skills/open-source-launch/` directory. `DISABLE_TELEMETRY=1` opts out
of the installer CLI's anonymous telemetry; Open Source Launch itself has no
telemetry.

Alternatively, ask Codex's built-in Skill Installer:

```text
Use $skill-installer to install open-source-launch from
https://github.com/JNHFlow21/open-source-launch/tree/main/skills/open-source-launch
```

Or run the same installer helper directly:

```bash
python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo JNHFlow21/open-source-launch \
--path skills/open-source-launch
```

Start a new Codex turn after installation so the Skill can be discovered.
Start a new Codex turn after either route so the Skill can be discovered.

### 2. Run a read-only launch audit

Expand Down Expand Up @@ -180,6 +184,7 @@ the public README URL never contains a long-lived token.
## Requirements and boundaries

- Designed and verified for Codex Skills; other `SKILL.md`-compatible agents may work but are not part of the verified support claim.
- Node.js with `npx` is required only for the canonical project-local install route; the Skill runtime does not depend on Node.js.
- Python 3.10+ is required only for the deterministic helper scripts.
- `git` is required for tracked-file and working-tree evidence.
- `gh`, authenticated owner access, and Gitleaks are optional and used only for the corresponding GitHub/secret-history gates.
Expand Down
26 changes: 15 additions & 11 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,24 +37,27 @@ Open Source Launch 为 Codex 提供一套可重复执行的发布契约:

## 快速开始

### 1. 使用 Codex 内置 Skill Installer 安装
### 1. 安装到当前项目

对 Codex 说:
```bash
DISABLE_TELEMETRY=1 npx skills add JNHFlow21/open-source-launch \
--skill open-source-launch \
--agent codex \
--yes
```

这条已验证路径会把 Skill 安装到当前项目的
`.agents/skills/open-source-launch/`。`DISABLE_TELEMETRY=1` 用于关闭安装器 CLI
的匿名遥测;Open Source Launch 本身不包含遥测。

也可以让 Codex 内置 Skill Installer 完成安装:

```text
Use $skill-installer to install open-source-launch from
https://github.com/JNHFlow21/open-source-launch/tree/main/skills/open-source-launch
```

也可以直接调用同一个安装器:

```bash
python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo JNHFlow21/open-source-launch \
--path skills/open-source-launch
```

安装后开启一个新的 Codex 轮次,让系统重新发现 Skill。
通过任一路径安装后,都要开启一个新的 Codex 轮次,让系统重新发现 Skill。

### 2. 执行只读发布审计

Expand Down Expand Up @@ -171,6 +174,7 @@ python3 skills/open-source-launch/scripts/install_repository_pulse.py \
## 要求与边界

- 为 Codex Skills 设计并验证;其他兼容 `SKILL.md` 的 Agent 可能可用,但不属于已验证支持声明。
- 只有项目级标准安装路径需要带 `npx` 的 Node.js;Skill 运行时不依赖 Node.js。
- 只有确定性辅助脚本需要 Python 3.10+。
- 需要 `git` 才能提供被跟踪文件和工作区状态证据。
- `gh`、仓库 Owner 权限和 Gitleaks 都是可选项,仅用于对应的 GitHub 或历史密钥门禁。
Expand Down