开源管道技能
通过一个3阶段管道安全地将任何项目开源：Fork（剥离密钥）→ Sanitize（验证干净）→ Package（生成CLAUDE.md + setup.sh + README）。
何时激活
- 用户说“将这个项目开源”或“使其公开”
- 用户准备将私有仓库公开发布
- 用户需要在推送到GitHub前剥离密钥
- 用户调用
/opensource fork、/opensource verify或/opensource package
命令
| 命令 | 操作 |
|---|---|
/opensource fork PROJECT | 完整管道：fork + sanitize + package |
/opensource verify PROJECT | 对已有仓库运行清洗器 |
/opensource package PROJECT | 生成 CLAUDE.md + setup.sh + README |
/opensource list | 显示所有已暂存的项目 |
/opensource status PROJECT | 显示暂存项目的报告 |
协议
/opensource fork PROJECT
完整管道——主要工作流。
步骤1：收集参数
解析项目路径。如果 PROJECT 包含 /，则视为路径（绝对或相对）。否则依次检查：当前工作目录、$HOME/PROJECT，然后询问用户。
SOURCE_PATH="<已解析的绝对路径>"
STAGING_PATH="$HOME/opensource-staging/${PROJECT_NAME}"
询问用户：
- “哪个项目？”（如果未找到）
- “许可证？（MIT / Apache-2.0 / GPL-3.0 / BSD-3-Clause）”
- “GitHub组织或用户名？”（默认：通过
gh api user -q .login检测） - “GitHub仓库名？”（默认：项目名称）
- “README描述？”（通过分析项目获取建议）
步骤2：创建暂存目录
mkdir -p $HOME/opensource-staging/
步骤3：运行分支器智能体
生成 opensource-forker 智能体：
Agent(
description="分支 {PROJECT} 用于开源",
subagent_type="opensource-forker",
prompt="""
为开源发布分支项目。
来源：{SOURCE_PATH}
目标：{STAGING_PATH}
许可证：{chosen_license}
遵循完整的分支协议：
1. 复制文件（排除 .git、node_modules、__pycache__、.venv）
2. 剥离所有密钥和凭证
3. 将内部引用替换为占位符
4. 生成 .env.example
5. 清理Git历史
6. 在 {STAGING_PATH}/FORK_REPORT.md 中生成 FORK_REPORT.md
"""
)
等待完成。读取 {STAGING_PATH}/FORK_REPORT.md。
步骤4：运行清洗器智能体
生成 opensource-sanitizer 智能体：
Agent(
description="验证 {PROJECT} 的清洗结果",
subagent_type="opensource-sanitizer",
prompt="""
验证开源分支的清洗情况。
项目：{STAGING_PATH}
来源（用于参考）：{SOURCE_PATH}
运行所有扫描类别：
1. 密钥扫描（CRITICAL）
2. PII扫描（CRITICAL）
3. 内部引用扫描（CRITICAL）
4. 危险文件检查（CRITICAL）
5. 配置完整性（WARNING）
6. Git历史审计
在 {STAGING_PATH}/ 内生成 SANITIZATION_REPORT.md，包含 PASS/FAIL 判定。
"""
)
等待完成。读取 {STAGING_PATH}/SANITIZATION_REPORT.md。
如果结果为 FAIL： 向用户展示发现。询问：“修复这些问题并重新扫描，还是中止？”
- 如果修复：应用修复，重新运行清洗器（最多重试3次——3次FAIL后，展示所有发现并让用户手动修复）
- 如果中止：清理暂存目录
如果结果为 PASS 或 PASS WITH WARNINGS： 继续到步骤5。
步骤5：运行打包器智能体
生成 opensource-packager 智能体：
Agent(
description="打包 {PROJECT} 用于开源",
subagent_type="opensource-packager",
prompt="""
为项目生成开源打包文件。
项目：{STAGING_PATH}
许可证：{chosen_license}
项目名：{PROJECT_NAME}
描述：{description}
GitHub仓库：{github_repo}
生成：
1. CLAUDE.md（命令、架构、关键文件）
2. setup.sh（单命令引导，设为可执行）
3. README.md（或增强现有文件）
4. LICENSE
5. CONTRIBUTING.md
6. .github/ISSUE_TEMPLATE/（bug_report.md、feature_request.md）
"""
)
步骤6：最终审查
向用户展示：
开源分支就绪：{PROJECT_NAME}
位置：{STAGING_PATH}
许可证：{license}
生成的文件：
- CLAUDE.md
- setup.sh（可执行）
- README.md
- LICENSE
- CONTRIBUTING.md
- .env.example（{N} 个变量）
清洗结果：{sanitization_verdict}
后续步骤：
1. 审查：cd {STAGING_PATH}
2. 创建仓库：gh repo create {github_org}/{github_repo} --public
3. 推送：git remote add origin ... && git push -u origin main
是否继续创建GitHub仓库？（是/否/先审查）
步骤7：GitHub发布（用户批准后）
cd "{STAGING_PATH}"
gh repo create "{github_org}/{github_repo}" --public --source=. --push --description "{description}"
/opensource verify PROJECT
独立运行清洗器。解析路径：如果 PROJECT 包含 /，则视为路径。否则依次检查 $HOME/opensource-staging/PROJECT、$HOME/PROJECT、当前目录。
Agent(
subagent_type="opensource-sanitizer",
prompt="验证清洗：{resolved_path}。运行全部6类扫描并生成 SANITIZATION_REPORT.md。"
)
/opensource package PROJECT
独立运行打包器。询问“许可证？”和“描述？”，然后：
Agent(
subagent_type="opensource-packager",
prompt="打包：{resolved_path} ..."
)
/opensource list
ls -d $HOME/opensource-staging/*/
显示每个项目及其管道进度（FORK_REPORT.md、SANITIZATION_REPORT.md、CLAUDE.md 是否存在）。
/opensource status PROJECT
cat $HOME/opensource-staging/${PROJECT}/SANITIZATION_REPORT.md
cat $HOME/opensource-staging/${PROJECT}/FORK_REPORT.md
暂存布局
$HOME/opensource-staging/
my-project/
FORK_REPORT.md # 来自分支器智能体
SANITIZATION_REPORT.md # 来自清洗器智能体
CLAUDE.md # 来自打包器智能体
setup.sh # 来自打包器智能体
README.md # 来自打包器智能体
.env.example # 来自分支器智能体
... # 清洗后的项目文件
反模式
- 绝不 未经用户批准推送到GitHub
- 绝不 跳过清洗器——它是安全门
- 绝不 在清洗器FAIL且未修复所有关键问题的情况下继续
- 绝不 将
.env、*.pem或credentials.json留在暂存目录中
最佳实践
- 对于新版本，始终运行完整管道（fork → sanitize → package）
- 暂存目录在显式清理前持久保留——用于审查
- 在手动修复后，发布前重新运行清洗器
- 将密钥参数化而非删除——保持项目功能
相关技能
参见 security-review，了解清洗器使用的密钥检测模式。