Basic Design
spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。
Install
/plugin marketplace add yasunori0418/skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add yasunori0418/skills --skill basic-designgit clone --depth 1 https://github.com/yasunori0418/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/product/basic-design ~/.claude/skills/basic-designPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# basic-design: 基本設計書の作成・改訂 feature-spec と対をなす **基本設計書 1 本** を作る単機能スキル。成果物は `docs/dev/<対象>/basic-design.md`。仕様が「何を満たすか(`REQ-#`)」を定義するのに対し、 基本設計は **「どう実現するか」** を定義し、各機能を `REQ-#` へ紐づけて **要求に紐づかない機能 = スコープ外混入** を機械検出可能にする。 ## このスキルがやらないこと - **実装しない**。コードの作成・修正は範囲外。 - **仕様を書かない・改訂しない**。要求の追加・変更が必要になったら `/feature-spec <対象>` の改訂モードへ回す(設計側で要求を勝手に足さない。それがスコープドリフトの発生源)。 - **詳細設計に踏み込みすぎない**。クラス単位の内部実装・アルゴリズムの逐次手順は実装工程の 領分。基本設計は **境界(モジュール・インターフェース・データの流れ)** までを確定させる。 - **テスト成果物を作らない・直さない**。`docs/test/<対象>/` は testing スキル群の担当。 ## このスキルが従う原則 ### 1. 単体動作(graceful degradation) - 成果物の既定パスは **`docs/dev/<対象>/basic-design.md`**。 - **プロジェクト側(`CLAUDE.md` / `AGENTS.md` 等)に成果物の配置規約があればそちらを優先する**。 - 主入力: **`docs/dev/<対象>/spec.md`**(`REQ-#` を参照して機能一覧を導出する)。 - 任意入力(あれば整合を取るが、無くても成立する): - `docs/test/<対象>/test-analysis.md`(テスト条件 `TC-#`。観測点・境界の洗い出しに使う) - `docs/test/<対象>/test-case.md`(テストケース `CASE-#`。設計が想定する入出力と突合する) - `docs/dev/definition-of-done.md`(完成の定義) - 任意のレビュードキュメント・ユーザーの直接指示 - **`spec.md` が無くても作れる**。ユーザーの直接指示・任意のレビュードキュメントを入力に 設計書を書いてよい。ただしその場合、機能一覧の「対応要求」列が `-` になり、 セルフ機械検査が「要求に紐づかない機能」として検出する。 **先に `/feature-spec <対象>` を実行して仕様を確定させることを推奨する** 旨を利用者へ伝え、 それでも進めるなら検査 NG が出ることを了解のうえで進める。 ### 2. 調査優先 + 決定のみ質問 - **事実はリポジトリ調査で埋める**。既存のモジュール構成・レイヤ分け・命名規約・ 依存の向き・公開契約は、利用者に訊く前に自分で調べる。既存構成に馴染む設計を出す。 - **利用者にしか決められない判断だけ** を `AskUserQuestion`(推奨案を先頭)で確認する。 本スキルでは **設計方式の選択・既存構成を変えるか否か・分割の粒度・改訂提案の採否** が これに当たる。トレードオフのある選択は選択肢と代償を添えて訊く。
Details
- Skill name
basic-design- Repository
- yasunori0418/skills
- Path
skills/product/basic-design/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
FAQ
What does the Basic Design skill do?
spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。
How do I install the Basic Design skill?
Claude Code plugin: /plugin marketplace add yasunori0418/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Basic Design popular?
It lives in yasunori0418/skills, which has 9 GitHub stars and 0 forks.
Related skills
Agent Teams
9yasunori0418/skills
Claude Code の並列エージェント(agent teams・teammate)の後始末と無応答時の打ち切りルール。`name` を付けて Agent を起動するとき、TeamCreate でチームを組むとき、teammate から `idle_notification` が届いたとき、評価ループ等で次のイテレーションのエージェントを起動する前、エージェントの返信が届かないときに参照する。`name` を付けない通常のサブエージェント起動だけなら対象外。
Biz Translate
9yasunori0418/skills
技術的な内容を、技術用語を排したビジネス職向けの平易な説明文に翻訳する。`/biz-translate` と明示的に呼ばれたときのみ実行する。
Commit Flow
9yasunori0418/skills
`git commit` / `git commit --amend` を実行する前、または「commit」「amend」「コミット」「コミットして」の一語・短文だけを渡された時点で必ず発火する git コミット実施ルール。理由や差分の説明が一切無くても、ファイル全文を読んでメッセージを組み立てる前に先に参照する。主目的は論理的に独立した修正を都度・適切な粒度でコミットすること。メッセージは Conventional Commits 形式、素材は同梱の決定論スクリプト commit-context.sh が出す staged diff のみ。「コミット分けて」と依頼される、独立した複数修正をまとめるか分けるか判断する、レビューコメント対応をコミットする、rebase / squash / cherry-pick 後のメッセージを整える、`gh pr create` の PR タイトルをコミット流儀へ揃える場面でも参照する。plan モードでのコミット計画の立案は commit-plan スキルの領分。
Wechat Writer
5TabithaFanny/claude-skills-collection
HelloTalk 公众号内容创作 workflow 支持 5 种任务:做选题 / 写文章 / 润色 / 审核 / 发布检查
External Writes
9yasunori0418/skills
Notion・Slack・GitHub Issue/PR・Linear等の外部システムへの書き込み・更新・コメント操作時の運用ルール。MCP書き込み系操作、Notion転記、Slack投稿、Issue/PRコメント、Linearチケット更新等を実行するときに必ず参照する。URLが会話に登場しても自動更新しないという原則を含む。
Competition Proposal Writing
5TabithaFanny/claude-skills-collection
比赛计划书写作助手,采用六阶段架构:项目主档→Research补证据→分析稿→成稿→Review修订→统稿可视化。 当用户提到:大创计划、挑战杯、创青春、互联网+、商赛、商业计划书、路演、答辩、融资计划、财务预测、市场分析、竞品分析、配图、格式调整时使用。
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.