# 可移植软件工程技能集

`Agent Skills` `工作流` `代码审计` `CLI工具` `开发流程`

# skills

适用于支持 [Agent Skills](https://agentskills.io/) 标准的工具的可移植软件工程技能集。

## 通过 `npx skills` 安装

```bash
# 列出可用技能
npx skills add a1exmozz/skills --list

# 安装单个技能
npx skills add a1exmozz/skills --skill audit-codebase-integrity

# 安装 devflow 工作流（brief、map、plan、raise、ship）
npx skills add a1exmozz/skills --skill devflow
```

该命令会将技能安装到目标 Agent 对应的技能目录中。关于支持的 Agent 及安装目标，请参阅 [`npx skills add --help`](https://github.com/vercel-labs/skills)。

## 本地校验

```bash
./scripts/validate-local.sh
```

该脚本会执行：

- 引用索引校验：`scripts/validate-reference-index.sh`
- 对 `skills/` 目录下每个技能进行 Agent Skills 校验

安装仓库 Git 钩子：

```bash
./scripts/install-git-hooks.sh
```

## 当前技能列表

| 技能 | 描述 |
|---|---|
| [audit-codebase-integrity](skills/audit-codebase-integrity/) | 涵盖 19 个领域的结构化完整性审计，用于排查隐性缺陷、设计缺陷和运行时正确性风险。 |
| [devflow](skills/devflow/) | 五阶段软件交付工作流：brief、map、plan、raise、ship。一次安装，获取所有阶段。 |
| [dev-brief](skills/devflow/dev-brief/) | 启动新工作的结构化探索流程，明确目标、成功标准及关键设计决策。 |
| [dev-map](skills/devflow/dev-map/) | 将 Brief 转化为领域驱动设计的 Map，包含统一语言、子域、限界上下文及关键领域流程。 |
| [dev-plan](skills/devflow/dev-plan/) | 将 Map 转化为基于依赖感知的细垂直实现切片的 Plan。 |
| [dev-raise](skills/devflow/dev-raise/) | 将 Plan 转化为具有依赖感知的 beads issues。 |
| [dev-ship](skills/devflow/dev-ship/) | 使用测试驱动开发方式实现 beads issues。 |

## 许可证

[MIT](LICENSE)