# skills

**Repository Path**: tttJour/skills

## Basic Information

- **Project Name**: skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TTTJour Skills Marketplace

这是一个 Codex 插件 Marketplace。插件可以携带一个或多个 Skill；安装插件后，对应 Skill 会进入 Codex / Super-CX 的技能发现列表。

## Marketplace Root 规则

配置外部 Marketplace 时填写仓库根目录，而不是 `marketplace.json` 文件或 `plugins/` 目录：

```text
/Users/user/skills
```

仓库使用以下结构：

```text
.
├── .agents/plugins/marketplace.json
└── plugins/
    └── <plugin-name>/
        ├── .codex-plugin/plugin.json
        └── skills/<skill-name>/SKILL.md
```

关键约束：

- Marketplace 文件固定为 `.agents/plugins/marketplace.json`。
- `marketplace.json` 的 `name` 必须唯一；插件条目的 `name` 必须和插件目录、`plugin.json.name` 一致。
- 本地插件来源使用 `source.source = "local"`。
- `source.path` 从 Marketplace root 解析，本仓库统一使用 `./plugins/<plugin-name>`。
- 每个插件必须包含 `.codex-plugin/plugin.json`，并使用 `"skills": "./skills/"` 声明 Skill 根目录。
- 每个 Skill 子目录必须包含带有效 YAML frontmatter 的 `SKILL.md`。

## 在 Super-CX / Codex 中安装

1. 打开“插件 → 高级 → 添加 Marketplace 来源”。
2. Marketplace 来源填写 `/Users/user/skills`，分支和 sparse path 留空。
3. 添加成功后回到插件市场，从 `产链插件市场` 中选择 `superpowers` 安装。
4. 安装完成后刷新技能列表；已有会话未更新时，强制重新加载技能或新建会话。

也可以使用 Codex CLI：

```bash
codex plugin marketplace add /Users/user/skills
codex plugin add superpowers@indus_plugins
```

执行 CLI 命令前可通过 `codex plugin --help` 确认当前版本支持的参数。

## Superpowers 插件

本仓库将 [obra/superpowers](https://github.com/obra/superpowers) 官方 Codex 兼容 Skill 合并封装为一个可安装插件：`superpowers`。安装该插件后，14 个 Superpowers Skill 会一起进入技能发现列表。

导入来源：

- 上游发布版：`v6.1.1`
- 上游版本：`6.1.1`
- 上游提交：`d884ae04edebef577e82ff7c4e143debd0bbec99`
- 上游作者：Jesse Vincent（obra）
- 许可证：MIT

聚合插件包含 `LICENSE` 和 `ATTRIBUTION.md`。`ATTRIBUTION.md` 记录上游版本、提交和本地 Codex 聚合插件封装方式。

| 插件 | Skill | 用途 |
|---|---|---|
| `superpowers` | `brainstorming` | 实施前澄清需求并形成获批设计。 |
| `superpowers` | `dispatching-parallel-agents` | 将互不依赖的工作分派给并行代理。 |
| `superpowers` | `executing-plans` | 按检查点执行已经批准的实施计划。 |
| `superpowers` | `finishing-a-development-branch` | 验证并安全结束开发分支。 |
| `superpowers` | `receiving-code-review` | 在应用代码审查意见前进行技术核验。 |
| `superpowers` | `requesting-code-review` | 对已完成的实现发起结构化代码审查。 |
| `superpowers` | `subagent-driven-development` | 使用独立子代理和分阶段审查执行计划。 |
| `superpowers` | `systematic-debugging` | 依据证据定位根因后再修改代码。 |
| `superpowers` | `test-driven-development` | 通过失败测试和最小实现推进开发。 |
| `superpowers` | `using-git-worktrees` | 为任务建立隔离的 Git worktree。 |
| `superpowers` | `using-superpowers` | 为当前任务选择并遵循合适的 Superpowers 工作流。 |
| `superpowers` | `verification-before-completion` | 在声明完成前要求最新验证证据。 |
| `superpowers` | `writing-plans` | 根据获批设计编写可执行实施计划。 |
| `superpowers` | `writing-skills` | 创建并验证可复用的 Agent Skill。 |

安装聚合插件：

```bash
codex plugin add superpowers@indus_plugins
```

安装后无需再分别安装 14 个独立 Superpowers 插件。旧的独立插件目录仍保留在仓库中作为来源快照和回滚参考，但 Marketplace 当前只暴露 `superpowers` 聚合插件。

### 多代理功能

以下 Skill 的完整工作流需要 Codex 多代理能力：

- `dispatching-parallel-agents`
- `requesting-code-review`
- `subagent-driven-development`
- `writing-skills`

在 Codex 配置中启用：

```toml
[features]
multi_agent = true
```

插件不会自动修改 Codex 配置。未启用时仍可安装，但相关子代理编排或基于子代理的验证工作流无法完整运行。