Agent skill

Dev Plan

by Stanshy in Stanshy/AgentHub

Generate a development plan with task breakdown and section 10 tracking tables

MITAuto-check: notesAgent Workflows

Install Dev Plan

skills CLI
$ npx skills add Stanshy/AgentHub --skill dev-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Stanshy/AgentHub dev-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Stanshy/AgentHub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.knowledge/company/skill-templates/dev-plan .claude/skills/dev-plan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dev-plan
GitHub stars
202
Token cost
~686 tokens
SKILL.md length
140 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Generate a development plan with task breakdown and section 10 tracking tables

  • Works in 3 steps: 建立規範文件(若不存在則建立,已存在則跳過) → 建立 Sprint Branch → 產出 proposal/sprint$0-dev-plan.md,包含
  • Tasks that involve Task breakdown
  • SKILL.md covers 使用方式, 參數, 執行步驟 and 第 10 節格式(強制), plus 1 more section
  • Calls git

What it does

Dev Plan is an agent skill from Stanshy/AgentHub. Generate a development plan with task breakdown and section 10 tracking tables

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Task breakdown and Skill authoring. The repository describes itself as: One person, one software company. Manage 47 AI agents from a single Electron app — with Harness Engineering (Skills + Hooks + FileWatchers) for disciplined, traceable AI workflows. The licence is MIT.

When your agent uses it

  • Tasks that involve Task breakdown
  • Tasks that involve Skill authoring

Example prompts

  • “/dev-plan”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Glob, Grep, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 建立規範文件(若不存在則建立,已存在則跳過)
  2. 建立 Sprint Branch
  3. 產出 proposal/sprint$0-dev-plan.md,包含

What it can do on your machine

Read from SKILL.md and the folder at commit 5300820. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Glob
    • Grep
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dev Plan loads about 686 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 140 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~686

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Glob, Grep, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Stanshy/AgentHub at commit 5300820, republished under its MIT licence (© Stanshy). 140 words, ~686 tokens.

Download SKILL.mdSave it as .claude/skills/dev-plan/SKILL.md (or your agent's skills folder).
name
dev-plan
description
Generate a development plan with task breakdown and section 10 tracking tables
allowed-tools
Read, Write, Glob, Grep, Bash

開發計畫書產生器

G0 通過後,由 L1 產出標準化開發計畫書。

使用方式

/dev-plan <sprint-number> <project-name>

參數

  • $0: Sprint 編號
  • $1: 專案名稱

執行步驟

  1. 讀取對應的提案書: !cat proposal/sprint$0-proposal.md 2>/dev/null || echo "找不到 Sprint $0 提案書"

  2. 讀取開發計畫書範本: !cat .knowledge/templates/dev-plan.md.template 2>/dev/null || echo "範本未找到"

  3. 建立規範文件(若不存在則建立,已存在則跳過):

    ⚠️ 規範文件是 Code Review「對規範」的比對對象,缺少 = Review 品質打折。 必須在 dev-plan 產出時一併建立,不得延後。

    mkdir -p .knowledge/specs

    建立以下三個檔案(內容從提案書 + 技術方案提取):

    檔案內容來源
    .knowledge/specs/api-design.mdAPI 端點清單、請求/回應格式、錯誤碼提案書需求 + 技術方案
    .knowledge/specs/data-model.md資料表定義、欄位型別、關聯、索引技術方案 DB 設計
    .knowledge/specs/feature-spec.md功能規格、用戶流程、邊界條件、驗收標準提案書功能清單

    每個檔案格式:

    markdown
    # {標題}
    
    > 版本: v1.0 | Sprint {N} | 最後更新: {YYYY-MM-DD}
    
    ## 概述
    {簡述}
    
    ## 詳細規格
    {具體內容}
  4. 建立 Sprint Branch:

    bash
    BASE=$(git rev-parse --abbrev-ref HEAD)   # 記錄當前 base branch(main / master / 其他)
    git checkout -b sprint-$0

    若 sprint-$0 branch 已存在,輸出警告並跳過(冪等)。 $BASE 將寫入 dev-plan metadata,供 /sprint-close 使用。

  5. 產出 proposal/sprint$0-dev-plan.md,包含:

    • 需求摘要(來自提案書)
    • 技術方案
    • 檔案變更清單
    • 介面設計(如需要)
    • 第 5 節:規範文件索引(指向 .knowledge/specs/ 下的三個檔案)
    • 第 6 節:任務拆解表(含依賴圖)
    • 驗收標準
    • 異常處理
    • 時程預估
    • 第 10 節:預建空表格(任務完成紀錄 / Review 紀錄 / Gate 紀錄)

第 10 節格式(強制)

⚠️ 此區域的表頭名稱與欄位順序被系統 parser (parseDevPlanSection10) 嚴格依賴。 不得更改表頭名稱、欄位順序、或子標題名稱。

markdown
## 10. 任務與審核紀錄(備查)

> 每個任務完成後記錄結果,每次 Review/Gate 通過後記錄決策。本區作為 Sprint 完整稽核軌跡。

### 任務完成紀錄

| 任務 | 完成日期 | 結果 | 備註 |
|------|---------|------|------|
| T1 | | | |
| T2 | | | |
(依第 6 節任務清單預建所有任務行)

### Review 紀錄

| Review 步驟 | 日期 | 結果 | Review 文件連結 |
|------------|------|------|---------------|
| UI 圖稿 Review | | | |
| 實作 Review | | | |
| 測試 Review | | | |
(依確認流程中的步驟預建行)

### Gate 紀錄

| Gate | 日期 | 決策 | 審核意見 |
|------|------|------|---------|
| G0 | | | |
| G1 | | | |
(依確認流程中的 Gate 預建行,空行 = 未審核)
欄位值規範(供後續 skill 填寫時遵守)

任務結果欄位(normalizeStatus 解析):

值系統狀態
✅ 完成done
🔧 需修正in_review
🔄 進行中in_progress

Gate 決策欄位(decisionToStatus 解析):

值系統狀態
✅ 通過approved
❌ 駁回rejected
⚠️ 附條件通過approved

Review 結果欄位:通過 / 不通過(目前僅存字串,不做狀態轉換)

日期格式:YYYY-MM-DD

Dev-plan Metadata(標題區)

dev-plan 標題區必須包含以下欄位(供其他 Skill 讀取):

markdown
> **Base Branch**: {master / main / 其他}
> **Sprint Branch**: sprint-{N}

© Stanshy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .knowledge/company/skill-templates/dev-plan of Stanshy/AgentHub.

Open the folder on GitHubat commit 5300820

Compare with similar skills

Dev Plan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dev Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dev Plan this skillStanshy/AgentHub202—~686Automated safety check: NotesMIT
Agent OrchestratorNeverSight/learn-skills.dev2161 repos~1.4kAutomated safety check: PassNone
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0

Similar skills

  • Agent Orchestrator

    NeverSight/learn-skills.dev

    Meta-agent skill for orchestrating complex tasks through autonomous sub-agents.

    216 GitHub starsUsed in 1 repo~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed

More from Stanshy/AgentHub

All 23 skills in this repo
  • Knowledge Feedback

    Stanshy/AgentHub

    Scan child projects for pitfalls and propose company standard updates

    202 GitHub stars~549 tokensUpdated 6 mo ago
    Auto-check: notes
  • Product Diagnosis

    Stanshy/AgentHub

    Six-question diagnostic framework for G0 pre-check — validate product direction before development starts

    202 GitHub stars~690 tokensUpdated 6 mo ago
    Auto-check passed
  • Project Kickoff

    Stanshy/AgentHub

    Initialize new project with CLAUDE.md, .knowledge/ structure, company rules, and git

    202 GitHub stars~528 tokensUpdated 6 mo ago
    Auto-check: notes
  • Review

    Stanshy/AgentHub

    L1 internal review with auto-detection, design comparison, and Gate escalation path

    202 GitHub stars~854 tokensUpdated 6 mo ago
    Auto-check: notes
  • Sop Plan

    Stanshy/AgentHub

    L1 計畫模式 SOP — 強制上下文載入 + Plan Mode 評估 + 任務拆解. An agent skill from Stanshy/AgentHub.

    202 GitHub stars~437 tokensUpdated 6 mo ago
    Auto-check: notes
  • Sop Review

    Stanshy/AgentHub

    L1 Code Review SOP — 強制規範對照 + 審核決策,不得跳過任何 checkpoint. An agent skill from Stanshy/AgentHub.

    202 GitHub stars~522 tokensUpdated 6 mo ago
    Auto-check: notes

Categories

Questions about Dev Plan

What does Dev Plan do?

Generate a development plan with task breakdown and section 10 tracking tables. Dev Plan is an agent skill from Stanshy/AgentHub.

When should I use Dev Plan?

Dev Plan fits situations like: tasks that involve Task breakdown; tasks that involve Skill authoring.

How do I install Dev Plan in Claude Code?

Run `npx skills add Stanshy/AgentHub --skill dev-plan -a claude-code`. Or copy the skill folder (.knowledge/company/skill-templates/dev-plan in Stanshy/AgentHub) into .claude/skills/dev-plan in your project. Claude Code loads it when a task matches its description.

How do I install Dev Plan in Codex?

Run `npx skills add Stanshy/AgentHub --skill dev-plan -a codex`. Or copy the skill folder (.knowledge/company/skill-templates/dev-plan in Stanshy/AgentHub) into .agents/skills/dev-plan in your project. Codex loads it when a task matches its description.

Can I use Dev Plan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Stanshy/AgentHub --skill dev-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dev-plan, .gemini/skills/dev-plan, .github/skills/dev-plan and .opencode/skills/dev-plan in your project.

What does Dev Plan need to run?

Going by SKILL.md and its folder, Dev Plan needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Read, Write, Glob, Grep, Bash.

Does Dev Plan access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Dev Plan safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Dev Plan use?

Dev Plan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dev Plan use?

About 686 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dev Plan?

Skills that share tags, products or a category with Dev Plan: Agent Orchestrator (NeverSight/learn-skills.dev, 216 stars), Skill Creator (Azure/azqr, 795 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars) and Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dev Plan?

Stanshy (a GitHub user) maintains it in Stanshy/AgentHub, which has 202 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on April 9, 2026.

Source: Stanshy/AgentHub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.