# Peinan Dotfiles Fix Issue

> fix-issue

- Skill: `tomevault-io/peinan-dotfiles-fix-issue` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/peinan-dotfiles-fix-issue`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/peinan-dotfiles-fix-issue/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/peinan-dotfiles-fix-issue

---


# fix-issue

GitHub Issue を解決するためのワークフロースキル。

## 引数

- `<issue番号>`: 解決対象の GitHub Issue 番号（必須）

## クイックスタート

1. Issue 取得: `gh issue view <番号> --json title,body,labels,comments`
2. コードベース調査: Explore エージェントで関連ファイル特定
3. プラン作成: 解決アプローチと実装ステップを提示
4. 承認後実装: ユーザー確認を経て変更を実行

## ワークフロー

### Phase 1: Issue 理解

Issue の内容を取得し分析する。

```bash
gh issue view <番号> --json title,body,labels,comments,assignees
```

分析ポイント:
- 問題の本質は何か
- 再現手順はあるか
- 期待される動作は何か
- **成功基準**: 何をもって解決とするか明確化

### Phase 2: コードベース調査

Explore エージェントを使用して詳細調査:
- Issue で言及されているファイル・関数
- エラーメッセージに含まれるキーワード
- 関連する既存のパターン・ユーティリティ

**セキュリティ評価**: auth, payments, infra 関連の場合は特に慎重に。

### Phase 3: プラン作成

1. 解決アプローチの候補を列挙
2. 各アプローチの tradeoff を分析
3. 推奨アプローチを選択
4. 実装ステップを詳述
5. **テスト計画**: 変更の検証方法を明記

### Phase 4: ユーザー承認

プランを提示し、質問・懸念点を確認。
承認されるまで実装に進まない。

### Phase 5: 実装

承認後、プランに従ってコード変更を実行。

## 注意事項

- AI はコードを提案するが、所有しない（Human-in-the-loop）
- セキュリティ関連の変更は特に慎重にレビュー
- 不明点があれば実装前に確認

詳細なワークフローは [references/workflow.md](references/workflow.md) を参照。

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/peinan) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->