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
8 changes: 8 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# GitHub account for this repository

- All authenticated GitHub operations for `codekongdev/plz` must use **`codekongdev`**. This includes issues, pull requests, comments, labels, releases, and pushes.
- Never use another account, including `planit-mason` or `YASICJUNWOO`, as a fallback, even if it is the default CLI or connector account.
- Before a GitHub operation, verify the authenticated login with `gh api user --jq .login` or an equivalent identity check. Use the same credentials for the check and the operation, and proceed only when the login is exactly `codekongdev`.
- The repository owner and the username in the remote URL do not verify the authenticated account. A connector must also pass the identity check before use.
- Prefer credentials scoped to the individual command or process. Do not switch the global GitHub account for other projects, and never print credentials or save them in repository files or logs.
- If `codekongdev` authentication is unavailable or cannot be verified, stop the GitHub operation and report the authentication problem. Do not act under a different account.
1 change: 1 addition & 0 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,7 @@ cp -R plz/skills/plz-3d-explain ~/.claude/skills/plz-3d-explain
| スキル | 作成するもの | デモ |
| --- | --- | --- |
| [plz-3d-explain](skills/plz-3d-explain/README.md) | 技術的な概念やシステム構成を three.js の 3D モデルで学べる、単一 HTML ファイルの学習ページ。 | [コードサンドボックス(英語)](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) · [韓国語](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) |
| [plz-setup-issues](skills/plz-setup-issues/README.md) | GitHub リポジトリの Issue ラベル、バグ・機能リクエストフォーム、トリアージ規則を設定します。 | — |

## コントリビュート

Expand Down
1 change: 1 addition & 0 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,7 @@ cp -R plz/skills/plz-3d-explain ~/.claude/skills/plz-3d-explain
| 스킬 | 만드는 것 | 데모 |
| --- | --- | --- |
| [plz-3d-explain](skills/plz-3d-explain/README.md) | 기술 개념과 시스템 구조를 three.js 3D 모형으로 공부하는 단일 HTML 학습 페이지를 만듭니다. | [코드 샌드박스(한국어)](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) · [영어](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) |
| [plz-setup-issues](skills/plz-setup-issues/README.md) | GitHub 저장소의 이슈 라벨, 버그·기능 요청 양식, 검토 규칙을 세팅합니다. | — |

## 기여

Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,7 @@ Details are in the [skill README](skills/plz-3d-explain/README.md).
| Skill | What it makes | Demo |
| --- | --- | --- |
| [plz-3d-explain](skills/plz-3d-explain/README.md) | A single HTML learning page with three.js 3D models of technical concepts and system structures. | [Code sandbox (English)](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) · [Korean](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) |
| [plz-setup-issues](skills/plz-setup-issues/README.md) | Issue labels, bug and feature forms, and triage rules for a GitHub repository. | — |

## Contributing

Expand Down
1 change: 1 addition & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,7 @@ cp -R plz/skills/plz-3d-explain ~/.claude/skills/plz-3d-explain
| 技能 | 生成内容 | 演示 |
| --- | --- | --- |
| [plz-3d-explain](skills/plz-3d-explain/README.md) | 用 three.js 3D 模型讲解技术概念和系统结构的单文件 HTML 学习页面。 | [代码沙箱(英语)](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.en.html) · [韩语](https://codekongdev.github.io/plz/skills/plz-3d-explain/assets/example-agent-sandbox.html) |
| [plz-setup-issues](skills/plz-setup-issues/README.md) | 设置 GitHub 仓库的议题标签、缺陷与功能请求表单和分诊规则。 | — |

## 参与贡献

Expand Down
50 changes: 50 additions & 0 deletions skills/plz-setup-issues/README.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# plz-setup-issues
[English](README.md) | [한국어](README.ko.md) | 日本語 | [简体中文](README.zh-CN.md)

GitHub リポジトリに、再利用できる簡潔な Issue 分類、フォーム、トリアージ規則を設定します。Claude Code と Codex に対応し、[plz](../../README.md) に含まれるスキルです。

## インストール

グローバルにインストール:

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -g
```

Codex では `-a codex` を付けます。以下のコマンドは現在のプロジェクトの `.agents/skills/` にインストールします。

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -a codex
```

## 使い方

Claude Code:

```text
/plz-setup-issues Set up issue management in this repository.
```

Codex:

```text
$plz-setup-issues Set up issue management in this repository.
```

ローカルファイルの作成のみを依頼することも、特定の GitHub リポジトリへのラベル適用を明示的に依頼することもできます。変更前に既存の設定を確認し、競合する規則は解決方針が決まるまで保持します。

## デフォルト構成

- 種類ラベル 5 個: `type:bug`、`type:feature`、`type:improvement`、`type:maintenance`、`type:docs`。
- 検討用ラベル 2 個: `needs-triage`、`needs-info`。
- バグ・機能リクエストフォーム、`.github/ISSUE_TRIAGE.md`、`.github/labels.json`。
- P0–P3 優先度: 既存のプロジェクト・組織フィールドを再利用し、なければ `priority:P0`–`priority:P3` ラベルで管理します。プロジェクトボードは自動作成しません。
- 領域・影響度・顧客の分類は必要な場合だけ追加します。

種類の主な分類には、リポジトリの種類ラベルか組織の Issue Type のいずれかを用い、同じ分類を重複管理しません。

## 対象範囲

設定の依頼は対象リポジトリに適用します。組織全体の種類変更、プロジェクトボードの作成、既存 Issue の再分類は、それぞれ依頼の範囲に含まれている必要があります。GitHub の変更には適切な認証と権限が必要ですが、利用できない場合もローカルの準備は完了できます。

手順は [SKILL.md](SKILL.md)、分類の判断基準は[分類ガイド](references/taxonomy.md)、デフォルトラベルは[ラベル一覧ファイル](assets/labels.json)を参照してください。
50 changes: 50 additions & 0 deletions skills/plz-setup-issues/README.ko.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# plz-setup-issues
[English](README.md) | 한국어 | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)

GitHub 저장소에 재사용할 수 있는 간결한 이슈 분류, 이슈 양식, 검토 규칙을 세팅합니다. Claude Code와 Codex에서 사용할 수 있으며, [plz](../../README.md)에 포함된 스킬입니다.

## 설치

전역으로 설치:

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -g
```

Codex에서 쓰려면 `-a codex`를 붙입니다. 아래 명령은 현재 프로젝트의 `.agents/skills/`에 설치합니다.

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -a codex
```

## 사용법

Claude Code:

```text
/plz-setup-issues Set up issue management in this repository.
```

Codex:

```text
$plz-setup-issues Set up issue management in this repository.
```

로컬 파일만 만들도록 요청하거나, 특정 GitHub 저장소에 라벨까지 적용하도록 명시할 수 있습니다. 변경 전에 기존 설정을 확인하며, 충돌하는 규칙은 해결 방향이 정해질 때까지 보존합니다.

## 기본 구성

- 작업 유형 라벨 5개: `type:bug`, `type:feature`, `type:improvement`, `type:maintenance`, `type:docs`.
- 검토 라벨 2개: `needs-triage`, `needs-info`.
- 버그·기능 요청 양식, `.github/ISSUE_TRIAGE.md`, `.github/labels.json`.
- P0–P3 우선순위: 기존 프로젝트·조직 필드가 있으면 재사용하고, 없으면 `priority:P0`–`priority:P3` 라벨로 관리합니다. 프로젝트 보드는 자동 생성하지 않습니다.
- 영역·영향도·고객사 분류는 필요한 경우에만 추가합니다.

작업 유형은 저장소의 유형 라벨 또는 조직의 Issue Type 중 하나를 주된 체계로 사용해 같은 분류를 중복 관리하지 않습니다.

## 범위

세팅 요청은 대상 저장소에 적용됩니다. 조직 전체 유형 변경, 프로젝트 보드 생성, 기존 이슈 재분류는 별도로 요청한 범위에 포함되어야 합니다. GitHub 변경에는 적절한 인증과 권한이 필요하며, 사용할 수 없어도 로컬 준비는 마칠 수 있습니다.

진행 절차는 [SKILL.md](SKILL.md), 분류를 정하는 기준은 [분류 가이드](references/taxonomy.md), 기본 라벨은 [라벨 목록 파일](assets/labels.json)을 참고하세요.
50 changes: 50 additions & 0 deletions skills/plz-setup-issues/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# plz-setup-issues
English | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md)

Set up issue management for a GitHub repository with a small, reusable taxonomy, issue forms, and written triage rules. Works with Claude Code and Codex. Part of [plz](../../README.md).

## Install

Install globally:

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -g
```

For Codex, add `-a codex`. This installs into the current project's `.agents/skills/` directory:

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -a codex
```

## Usage

Claude Code:

```text
/plz-setup-issues Set up issue management in this repository.
```

Codex:

```text
$plz-setup-issues Set up issue management in this repository.
```

You can request local files only, or explicitly ask to apply labels to a named GitHub repository. Existing settings are inspected before changes, and conflicting conventions are preserved until resolved.

## Defaults

- Five type labels: `type:bug`, `type:feature`, `type:improvement`, `type:maintenance`, and `type:docs`.
- Two review labels: `needs-triage` and `needs-info`.
- Bug and feature issue forms, `.github/ISSUE_TRIAGE.md`, and `.github/labels.json`.
- P0–P3 priority: reuse an existing project or organization field; otherwise use `priority:P0`–`priority:P3` labels. No project board is created automatically.
- Area, impact, and customer categories are added only when useful.

The skill uses one primary type system: repository type labels or organization Issue Types. It avoids duplicating the same classification across both.

## Scope

A setup request covers the target repository. Changing organization-wide types, creating a project board, and reclassifying existing issues require their own requested scope. GitHub changes need suitable authentication and permissions; local preparation can still be completed when these are unavailable.

See [SKILL.md](SKILL.md) for the workflow, [the taxonomy guide](references/taxonomy.md) for decisions, and [the label manifest](assets/labels.json) for default labels.
50 changes: 50 additions & 0 deletions skills/plz-setup-issues/README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# plz-setup-issues
[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | 简体中文

为 GitHub 仓库设置可复用的精简议题分类、议题表单和分诊规则。支持 Claude Code 和 Codex,是 [plz](../../README.md) 的一部分。

## 安装

全局安装:

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -g
```

在 Codex 中使用时加上 `-a codex`。以下命令安装到当前项目的 `.agents/skills/` 目录:

```sh
npx skills add codekongdev/plz --skill plz-setup-issues -a codex
```

## 使用方法

Claude Code:

```text
/plz-setup-issues Set up issue management in this repository.
```

Codex:

```text
$plz-setup-issues Set up issue management in this repository.
```

可以只请求生成本地文件,也可以明确要求向指定的 GitHub 仓库应用标签。修改前会检查现有设置,冲突的规则会保留,直到确定解决方案。

## 默认配置

- 5 个类型标签:`type:bug`、`type:feature`、`type:improvement`、`type:maintenance`、`type:docs`。
- 2 个审查标签:`needs-triage` 和 `needs-info`。
- 缺陷与功能请求表单、`.github/ISSUE_TRIAGE.md` 和 `.github/labels.json`。
- P0–P3 优先级:复用现有项目或组织字段;没有时使用 `priority:P0`–`priority:P3` 标签。不会自动创建项目看板。
- 仅在有用时添加领域、影响程度和客户分类。

主要类型分类采用仓库类型标签或组织 Issue Type 中的一种,避免对同一分类进行重复管理。

## 范围

设置请求适用于目标仓库。修改组织级类型、创建项目看板以及重新分类现有议题,需要分别包含在请求范围内。GitHub 修改需要适当的身份验证和权限;即使不可用,也可以完成本地准备。

工作流程见 [SKILL.md](SKILL.md),分类决策见[分类指南](references/taxonomy.md),默认标签见[标签清单](assets/labels.json)。
Loading