# coding-dev-skill

**Repository Path**: felixagents/coding-dev-skill

## Basic Information

- **Project Name**: coding-dev-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-06
- **Last Updated**: 2026-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Coding Dev Skill

软件开发技能集合，为 AI Agent 提供完整的软件开发生命周期支持。

## 项目简介

Coding Dev Skill 是一个 AI 驱动的软件开发技能库，将 obra/superpowers 和 mattpocock/skills 的核心技能进行了个人化的整理与合并，形成了一个连贯的方法论引擎。涵盖从需求分析、设计规划、编码实现到测试部署的完整流程。每个技能（Skill）都是独立的 AI 能力模块，可被 AI 助手调用以完成特定开发任务。

技能库围绕一条**主流程（想法 → 上线）**组织，辅以两条汇入线（issue 分诊、迷雾工程规划）和一组垫在下层的辅助技能。不确定从哪开始时，直接问 **skill-router**。

## 技能概览

### 主流程：想法 → 上线

| 技能 | 描述 |
|------|------|
| **brainstorming** | 头脑风暴与设计规划：任何创造性工作之前，探索用户意图、需求与设计；需要时展开为 PRD 流程 |
| **prd-write** | PRD 编写：分析需求、拆解任务，生成可执行的高质量产品需求文档（docs/prds/） |
| **prd-review** | PRD 评审：以严格、零容忍模糊的专家视角审查 PRD，识别遗漏场景、模糊 AC、技术风险 |
| **grill-with-docs** | 方案压力测试（有仓库版）：追问钉死模糊处，把领域语言沉淀进 GLOSSARY.md、把难逆转的决策沉淀进 ADR |
| **writing-plans** | 编写实施计划：把共识写成 TSP（docs/TSPs/），计划记录决策而非代码抄本 |
| **executing-plans** | 执行计划：亲自逐任务执行 TSP，task-start/task-done 循环、进度台账、仅有的四种停止条件 |
| **subagent-driven-development** | 子代理驱动开发：把每个任务派给子代理（简报 → 实现 → 审查 → 记账），编排构建而非亲手驱动 |
| **test-driven-development** | TDD：测试驱动开发，一次一片红-绿，test-first 构建功能与修复 bug |
| **requesting-code-review** | 请求代码审查：对 diff 做两轴审查（标准 + 规格），以"合理用户的期望"为裁决标准 |
| **verification-before-completion** | 完成前验证：先运行验证命令并确认输出，再宣告完成——证据，不是感觉 |
| **finishing-a-development-branch** | 分支收尾：验证测试后呈现合并 / PR / 保留 / 丢弃四个选项并执行 |
| **retro** | 复盘：回顾会话，改进代理的环境（导航指针、自动化检查、编码标准），而非追责代码 |

### 汇入线

| 技能 | 描述 |
|------|------|
| **triage** | Issue 分诊：让 issue 和外部 PR 走过分诊状态机，产出代理可直接开工的简报（AGENT-BRIEF） |
| **wayfinder** | 迷雾工程规划：为一次会话装不下的大工程在 issue 追踪器上绘制决策工单地图，产出决策而非交付物 |

### 垫在下层的辅助

| 技能 | 描述 |
|------|------|
| **using-superpowers** | 会话自动入口：工作开始时把相关技能拉进上下文 |
| **skill-router** | 技能路由器：说出你的处境，它告诉你走哪条路径、按什么顺序调用哪些技能 |
| **grill-me** | 方案压力测试（独立版）：无仓库可用时对方案做持续追问式压力测试 |
| **receiving-code-review** | 审查反馈处理：先技术性核实再实现，不做表演性同意 |
| **using-git-worktrees** | Git 工作树：为功能开发或 bug 修复开出隔离、安全的工作树 |
| **wait-what** | 消息纠偏：对一条没传达到位的消息，带着缺失的上下文重新表述 |
| **handoff** | 上下文交接：把当前对话压缩成交接文档，供全新代理接续 |

### 自有领域技能

| 技能 | 描述 |
|------|------|
| **git-commit** | Git 提交：生成符合约定式提交规范的提交信息 |
| **project-overview** | 项目概览：接手陌生仓库时先跑一遍，拿到架构与目录导览 |
| **pr** | PR 正文撰写：用摘要图示、前后证据和合并风险构成的结构化正文描述变更 |
| **pstest** | API 自动化测试：使用 pstest CLI 编写与运行 YAML 测试用例，导入 OpenAPI，生成报告与 Mock 数据 |
| **pstest-ui** | UI 自动化测试：使用 pstest ui CLI 进行 Playwright 关键字驱动 UI 自动化测试，支持 Excel/自然语言生成工程 |
| **frontend-design** | 前端设计：构建新 UI 或重塑现有 UI 时，给出有辨识度的视觉设计指导（美学方向、字体排印、去模板化） |

## 快速开始

### 安装技能

技能是包含 `SKILL.md` 的目录，把它放进你的 AI 工具的技能目录即可（以 Claude Code 为例）：

```bash
# 安装单个技能到用户级
cp -r skills/brainstorming ~/.claude/skills/

# 或安装全部技能
cp -r skills/* ~/.claude/skills/
```

安装后，Agent 在会话开始时由 `using-superpowers` 自动拉取相关技能；你也可以在对话中直接通过 Skill 工具调用，或对 Agent 说"帮我路由"让 `skill-router` 指路。

### 使用 pstest 进行 API 测试

```bash
# 生成测试用例
pstest generate --spec openapi.json

# 运行测试
pstest run --config config.yaml

# 生成报告
pstest report --output report.html
```

### 使用 pstest-ui 进行 UI 测试

```bash
# 新建测试项目
pstest ui new-project my-system --cookie "xxx" --url "https://..."

# 运行测试
pstest ui run --project ./my-system

# 调试模式
pstest ui debug --project ./my-system
```

## 项目结构

```
.
├── skills/
│   ├── brainstorming/                    # 头脑风暴与设计
│   ├── prd-write/                        # PRD 编写
│   ├── prd-review/                       # PRD 评审
│   ├── grill-with-docs/                  # 方案压力测试（有仓库版）
│   ├── grill-me/                         # 方案压力测试（独立版）
│   ├── writing-plans/                    # 编写实施计划（TSP）
│   ├── executing-plans/                  # 执行计划
│   ├── subagent-driven-development/      # 子代理驱动开发
│   ├── test-driven-development/          # TDD
│   ├── requesting-code-review/           # 请求代码审查
│   ├── verification-before-completion/   # 完成前验证
│   ├── finishing-a-development-branch/   # 分支收尾
│   ├── retro/                            # 复盘
│   ├── triage/                           # Issue 分诊
│   ├── wayfinder/                        # 迷雾工程规划
│   ├── using-superpowers/                # 会话自动入口
│   ├── skill-router/                     # 技能路由器
│   ├── receiving-code-review/            # 审查反馈处理
│   ├── using-git-worktrees/              # Git 工作树
│   ├── wait-what/                        # 消息纠偏
│   ├── handoff/                          # 上下文交接
│   ├── git-commit/                       # Git 提交
│   ├── project-overview/                 # 项目概览
│   ├── pr/                               # PR 正文撰写
│   ├── pstest/                           # API 自动化测试
│   ├── pstest-ui/                        # UI 自动化测试
│   └── frontend-design/                  # 前端视觉设计
```

## 统一文档存放约定

所有技能遵循下表的产物存放约定。用户显式指定的位置永远优先于此默认值：

| 产物 | 存放位置 | 创建者 |
|------|---------|--------|
| PRD | `docs/prds/PRD-[需求ID]-[描述].md` | prd-write |
| PRD 拆解概览 | `docs/prds/PRD-[需求ID]-overview.md` | prd-write |
| TSP（实施计划） | `docs/TSPs/MM-DD-YYYY-<feature-name>.md` | writing-plans |
| 术语表 | 根目录 `GLOSSARY.md`（多上下文经 `GLOSSARY-MAP.md` 索引） | grill-with-docs |
| 架构决策记录 | `docs/adr/NNNN-<标题>.md` | grill-with-docs |
| 迷雾工程地图 | `docs/wayfinder/<地图名>/`（无追踪器时的本地约定） | wayfinder |
| 范围外知识库 | `.out-of-scope/*.md` | triage |
| SDD 工作区（台账/简报/审查包） | `.superpowers/sdd/<TSP名>/` | executing-plans / subagent-driven-development |
| 技能编写模板 | `docs/SKILL-TEMPLATE.md` | 新增/修改技能时 |

## 文档

- [技能路由器](./skills/skill-router/SKILL.md) — 不确定用哪个技能时从这里开始
- [阶段边界判定树](./skills/skill-router/PHASE-BOUNDARIES.md) — 继续 / 清空 / 交接 / 派子代理 / 压缩的完整判定
- [pstest-ui 用户手册](./skills/pstest-ui/USER_GUIDE.md)
- [pstest 技能文档](./skills/pstest/README.md)
- [技能编写模板](./docs/SKILL-TEMPLATE.md) — 编写 SKILL.md 的唯一事实源

## 许可证

MIT License