software-designing
/software-designing
【非推奨】設計書を永続化しない運用へ移行したため非推奨。設計は実装時にPR本文とGitHubコメントへ記載し、要求の管理は requirement-management を使用すること。既存の docs/sdd/design/ を保守・参照する場合にのみ使用する。アーキテクチャ設計、コンポーネント定義、API設計、データベーススキーマのMarkdown文書を作成・編集する。Do NOT use for 新規プロジェクトの設計(設計はPR本文に記載すること)。
- Author
- windschord ↗
- Repository
- claude_skils ↗
- Licence
- Apache-2.0
- Last repository change
- 20.10.2026
Assessment and security
- Files in this package
- 9
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
【非推奨】設計書を永続化しない運用へ移行したため非推奨。設計は実装時にPR本文とGitHubコメントへ記載し、要求の管理は requirement-management を使用すること。既存の docs/sdd/design/ を保守・参照する場合にのみ使用する。アーキテクチャ設計、コンポーネント定義、API設計、データベーススキーマのMarkdown文書を作成・編集する。Do NOT use for 新規プロジェクトの設計(設計はPR本文に記載すること)。
Original author description
【非推奨】設計書を永続化しない運用へ移行したため非推奨。設計は実装時にPR本文とGitHubコメントへ記載し、要求の管理は requirement-management を使用すること。既存の docs/sdd/design/ を保守・参照する場合にのみ使用する。アーキテクチャ設計、コンポーネント定義、API設計、データベーススキーマのMarkdown文書を作成・編集する。Do NOT use for 新規プロジェクトの設計(設計はPR本文に記載すること)。
How it works
- 概要
- ドキュメント構成
- このスキルを使用する場面
- 前提条件
- 設計原則
- ワークフロー
- 検証チェックリスト
- 要件との整合性チェック
- ユーザーとの対話ガイドライン
- 後続スキルとの連携
SKILL.md preview
---
name: software-designing
description: 【非推奨】設計書を永続化しない運用へ移行したため非推奨。設計は実装時にPR本文とGitHubコメントへ記載し、要求の管理は requirement-management を使用すること。既存の docs/sdd/design/ を保守・参照する場合にのみ使用する。アーキテクチャ設計、コンポーネント定義、API設計、データベーススキーマのMarkdown文書を作成・編集する。Do NOT use for 新規プロジェクトの設計(設計はPR本文に記載すること)。
metadata:
version: "1.0.0"
---
# 設計スキル(非推奨)
> **⚠️ このスキルは非推奨です。**
>
> 設計書を永続化しない運用へ移行しました。設計書は書いた瞬間から実装とずれ始め、ずれた設計書は整合性チェックの対象を増やすだけになるためです。
>
> | | 非推奨(本スキル) | 移行先 |
> |---|---|---|
> | 設計の記録先 | `docs/sdd/design/`(永続化) | PR本文とGitHubコメント(永続化しない) |
> | 要求との紐付け | ドキュメント間の相互リンク | 要求の `verification` とPRのURL(`design_refs`) |
> | 要求の管理 | requirements-defining | `requirement-management` |
>
> 運用の詳細は `sdd/requirement-management/references/design_in_pr_ja.md`、移行手順は同 `references/migration_from_sdd_ja.md` を参照してください。
> 既存の `docs/sdd/design/` を保守・参照する場合にのみ、以下の手順を使用します。
技術アーキテクチャ、コンポーネント設計、API設計、データベーススキーマを文書化する設計書を作成します。
## 概要
このスキルは、以下の成果物を作成・管理します:
- **docs/sdd/design/index.md**: 設計概要(目次)
- **docs/sdd/design/components/*.md**: コンポーネント詳細
- **docs/sdd/design/api/*.md**: API設計詳細
- **docs/sdd/design/database/schema.md**: データベーススキーマ
- **docs/sdd/design/decisions/DEC-XXX.md**: 技術的決定事項
## ドキュメント構成
```text
docs/sdd/design/
├── index.md # 目次・アーキテクチャ概要
├── components/
│ ├── component-a.md # コンポーネント詳細
│ └── component-b.md
├── api/
│ ├── users.md # API設計詳細
│ └── items.md
├── database/
│ └── schema.md # データベーススキーマ
└── decisions/
├── DEC-001.md # 技術的決定事項
└── DEC-002.md
```
## このスキルを使用する場面
### 新規作成時
- 技術アーキテクチャを文書化したい場合
- コンポーネント設計を明確にしたい場合
- API設計を定義したい場合
- データベーススキーマを設計したい場合
### 既存ドキュメントの修正時
- docs/sdd/design/の設計内容を更新・変更する場合
- 新しいコンポーネントを追加する場合
## 前提条件
### requirements/との連携
docs/sdd/requirements/が存在する場合:
1. 要件を読み込み、設計との整合性を確認
2. すべての要件(REQ-XXX)に対応する設計要素があるか確認
3. 要件にない機能が設計に含まれていないか確認
## 設計原則
### コンポーネント設計
1. **単一責任の原則**: 各コンポーネントは1つの明確な目的を持つ
2. **疎結合**: コンポーネント間の依存関係を最小限に
3. **高凝集**: 関連する機能を同じコンポーネントに
4. **インターフェース定義**: 明確な入出力を定義
### API設計
- RESTful原則に従う
- 適切なHTTPステータスコードを使用
- バージョニング戦略を定義
- エラーレスポンスの一貫性
### データベース設計
- 正規化と非正規化のバランス
- インデックス戦略
- トランザクション境界
## ワークフロー
1. **要件確認**: docs/sdd/requirements/が存在すれば内容を確認
2. **情報分類**: 明示された情報と不明な情報を分類
3. **不明点確認**: 必要な情報をユーザーに確認
4. **ディレクトリ作成**: `docs/sdd/design/` 以下のサブディレクトリを作成
5. **各ドキュメント作成**: テンプレートを使用
6. **整合性確認**: requirements/との整合性をチェック
7. **ユーザー確認**: 承認を得て完了
## 検証チェックリスト
- [ ] アーキテクチャ概要が記載されている
- [ ] 主要コンポーネントが定義されている
- [ ] 技術的決定事項と根拠が記載されている
- [ ] 情報の明確性チェックが完了している
- [ ] requirements/の全要件に対応する設計要素がある
- [ ] CI/CD設計が含まれている
- [ ] 品質基準が定義されている(カバレッジ80%、ミューテーションスコア85%、Linter、複雑性)
## 要件との整合性チェック
docs/sdd/requirements/が存在する場合、以下を確認:
| チェック項目 | 確認内容 |
|-------------|---------|
| 機能カバレッジ | すべての要件(REQ-XXX)に対応する設計要素があるか |
| 非機能要件対応 | NFR-XXXの要件が設計に反映されているか |
| 過剰設計チェック | requirements/にない機能が設計に含まれていないか |
## ユーザーとの対話ガイドライン
### 確認が必要な場面
- アーキテクチャパターンの選択
- 技術スタックの選定
- データモデルの構造
- 外部サービスとの連携方法
### 推奨度付き選択肢の提示
```text
技術スタックについて確認させてください:
A) Next.js + TypeScript
推奨理由:モダンで型安全、SSR/SSG対応
B) React + JavaScript
推奨理由:シンプルで導入が容易
どれを選択しますか?
```
## 後続スキルとの連携
docs/sdd/design/の作成完了後:
- **task-planning**: design/を基にタスクを分解
task-planningスキルで逆順レビュー(タスク → 要求)が行われます。設計は逆順レビューの対象外です(PR本文の設計ノートと実装を突き合わせます)。
## リソース
### テンプレート
- 目次テンプレート: `assets/templates/design_index_template_ja.md`
- コンポーネントテンプレート: `assets/templates/component_template_ja.md`
- APIテンプレート: `assets/templates/api_template_ja.md`
- データベーステンプレート: `assets/templates/database_template_ja.md`
- 技術的決定テンプレート: `assets/templates/decision_template_ja.md`
### リファレンス
- 設計パターン: `references/design_patterns_ja.md`
- CI/CDガイド: `references/cicd_guide_ja.md`
- EARS記法(要件参照用): `references/ears_notation_ja.md`
### 命名規則
| ファイル種別 | 命名規則 | 例 |
|-------------|---------|-----|
| コンポーネント | ケバブケース | `user-service.md`, `auth-handler.md` |
| API | リソース名 | `users.md`, `items.md` |
| 技術的決定 | `DEC-XXX.md` | `DEC-001.md`, `DEC-002.md` |
Files in this package (9)
- SKILL.md 7 KB
- assets/templates/api_template_ja.md 4 KB
- assets/templates/component_template_ja.md 2 KB
- assets/templates/database_template_ja.md 4 KB
- assets/templates/decision_template_ja.md 2 KB
- assets/templates/design_index_template_ja.md 5 KB
- references/cicd_guide_ja.md 2 KB
- references/design_patterns_ja.md 2 KB
- references/ears_notation_ja.md 11 KB
Versions
The database has no other skills named software-designing.
Database snapshot: 13.11.2026 · package version 9c14552a4795 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100requirements-defining
【非推奨】requirement-management に統合された。新規の要件定義には requirement-management を使用すること。既存の docs/sdd/requirements/ を保守・参照する場合にのみ使用する。EARS記法によるMarkdownの要件定義書(ユーザーストーリー・受入基準・非機能要件)を作成・編集する。Do NOT use for 新規プロジェクトの要件定義(requirement-management を使用すること)。 - 100sdd-document-management
【非推奨】要求の整合性チェックは requirement-management の reqctl.py validate に統合された。既存の docs/sdd/ を保守する場合にのみ使用する。SDDドキュメントの整合性チェック、実装同期確認、アーカイブ(CLAUDE.md同期含む)、ファイル最適化を行う。Do NOT use for 要求の矛盾検出(requirement-management を使用すること)。 - 100sdd-planning
Generate technical plans from specifications. Use when creating architecture documents, designing system components, or preparing for implementation. - 100using-sdd
Routes every software-development request through the right SDD workflow before action. Use at session start, before clarifying questions, before edits, and whenever deciding which SDD skill should govern a task. - 100sdd-review
对 BiSheng 项目的 SDD 文档执行审查。 - spec:写完 spec.md 后调用,同时检查 PRD gap 和架构合规性,生成报告供用户参考 - design:写完 design.md 后调用,检查"接手测试"四要素(现状/决策/坑/契约),生成报告供用户参考 - tasks:写完 tasks.md 后自动调用,检查 AC 追溯、任务拆解质量和技术债预防 用法:/sdd-review <feature_dir> <doc_type>,doc_type 为 spec / design / tasks。 TRIGGER when: 用户完成了… - 100specify-solution
Create and validate solution design documents (SDD). Use when designing architecture, defining interfaces, documenting technical decisions, analyzing system components, or working on solution.md files in .start/specs/.