#898 by GitHub stars
zhu1090093659/spec_driven_develop
Spec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub Issue/PR tracking, Deep Discuss, and adaptive control for Claude Code, Codex, Cursor, and other Markdown-capable agents.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
plugins/spec-driven-develop/skills/deep-discuss/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 14f8c0f2be44
No earlier version was observed for comparison.
plugins/spec-driven-develop/skills/review-spd/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 14f8c0f2be44
No earlier version was observed for comparison.
plugins/spec-driven-develop/skills/spec-driven-develop/SKILL.md
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Local scripts
First observation → 14f8c0f2be44
No earlier version was observed for comparison.
Verified commit 14f8c0f2be4421d11b8eb7474cde3ee00fb52b14
git clone --filter=blob:none --no-checkout https://github.com/zhu1090093659/spec_driven_develop.git .hotskills/zhu1090093659-spec_driven_develop && git -C .hotskills/zhu1090093659-spec_driven_develop checkout --detach 14f8c0f2be4421d11b8eb7474cde3ee00fb52b14
# Copy each selected skill directory from .hotskills/zhu1090093659-spec_driven_develop into .claude/skills/<skill-name>/git clone --filter=blob:none --no-checkout https://github.com/zhu1090093659/spec_driven_develop.git .hotskills/zhu1090093659-spec_driven_develop && git -C .hotskills/zhu1090093659-spec_driven_develop checkout --detach 14f8c0f2be4421d11b8eb7474cde3ee00fb52b14
# Copy each selected skill directory from .hotskills/zhu1090093659-spec_driven_develop into .agents/skills/<skill-name>/Heat
2.7- Star growth, last 7 daysAhead of 36% of tracked repositories
- Star growth, last 24 hoursAhead of 71% of tracked repositories
- Rank movement, last 7 daysAhead of 2% of tracked repositories
- Commits, last 30 daysAhead of 0% of tracked repositories
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekAhead of 0% of tracked repositories
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
Individual skills in this repository
- deep-discuss
plugins/spec-driven-develop/skills/deep-discuss - review-spd
plugins/spec-driven-develop/skills/review-spd - spec-driven-develop
plugins/spec-driven-develop/skills/spec-driven-develop
How it works
deep-discuss
When your agent uses it
结构化深度讨论 Skill,用于与用户进行多轮问题分析和方案设计。当用户描述一个问题现象、故障表现、 技术困惑、方案选择困难,或明确说"讨论一下"、"帮我分析"、"我遇到一个问题"、"你觉得怎么样"、 "帮我想想"、"我在纠结"时,必须使用本 skill。当用户提供了一段描述(可能附带截图)并期望深入分析 而非直接给答案时,也应触发本 skill。即使用户只是抛出一个现象描述没有明确提问,也要使用本 skill 来引导结构化思考。不要在简单的事实查询("X是什么")或明确的执行指令("帮我写个脚本")上触发。
What it loads into context
Frontmatter
203 tokensAlways available to the agent
SKILL.md
1,084 tokensWhen the skill is activated
Reference documents
31,292 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- 通用规则
- Phase 1:接收信息
- Phase 2:问题审查(质量门控)
- Phase 3:深度分析
- Phase 4:方案设计
- Phase 5:方案自检
- Phase 6:最终确认
- Phase 7:执行(可选)
Scripts executed separately
../review-spd/scripts/review-context.py
Files
../../../../.claude-plugin/marketplace.jsonasset1,389 bytes../../.claude-plugin/plugin.jsonasset1,235 bytes../../agents/code-reviewer.mddoc3,568 bytes../../agents/code-reviewer.mddoc3,568 bytes../../agents/project-analyzer.mddoc4,410 bytes../../agents/task-architect.mddoc7,863 bytes../../agents/task-executor.mddoc9,112 bytes../../agents/task-executor.mddoc9,112 bytesSKILL.mdcore3,953 bytes../review-spd/SKILL.mddoc6,134 bytes../review-spd/references/output-format.mddoc1,830 bytes../review-spd/references/reviewer-template.mddoc1,895 bytes../review-spd/scripts/review-context.pyruns9,952 bytes../spec-driven-develop/SKILL.mddoc20,713 bytes../spec-driven-develop/references/adaptive-control.mddoc9,418 bytes../spec-driven-develop/references/behavioral-rules.mddoc7,118 bytes../spec-driven-develop/references/github-integration.mddoc15,399 bytes../spec-driven-develop/references/parallel-protocol.mddoc9,492 bytes../spec-driven-develop/references/super-philosophy.mddoc5,878 bytes../spec-driven-develop/references/templates/analysis.mddoc5,288 bytes../spec-driven-develop/references/templates/archive.mddoc1,767 bytes../spec-driven-develop/references/templates/governance.mddoc3,262 bytes../spec-driven-develop/references/templates/plan.mddoc6,537 bytes../spec-driven-develop/references/templates/progress.mddoc7,406 bytes
Read SKILL.md
# Deep Discuss — 结构化深度讨论
你正在执行 **Deep Discuss** 工作流:不急于给答案,先把问题想透。用户描述的"问题"和真正的问题之间常有鸿沟——这个流程用分阶段的纪律保证讨论的质量和深度。
## 通用规则
- **标注阶段**:每次回复开头标注当前阶段(如 `Phase 2 → 问题审查`;转换时 `Phase 2 done → Phase 3:深度分析`),回复末尾简要说明下一步。
- **不要跳阶段**:至少过一遍 Phase 1-4;Phase 5/6 可按问题复杂度合并,但不能完全跳过。用户中途提供新信息时,评估是否回到更早阶段。
- **信息不足即停**:Phase 2 发现信息不足时,先问再等,不要带着未验证的假设往下走。
- **直接坦诚**:用户判断有误就直说并给理由;不确定的事用置信度表述,不用模棱两可的"可能"。
## Phase 1:接收信息
只接收,不分析。完整理解用户提供的全部信息(文字、截图、用户的初步判断),用自己的话复述关键点(≤3-5 句)确认理解无误。描述明显模糊时,复述后只提 1-2 个最关键的澄清问题。View the complete source on GitHubreview-spd
When your agent uses it
Findings-first code review workflow for AI coding agents. Use when the user asks to review uncommitted changes, commits in a date range, or a branch compared to the main branch / PR-style diff. Focuses on bugs, regressions, correctness risks, missing tests, security/data-safety issues, and other behavior-changing defects.
What it loads into context
Frontmatter
91 tokensAlways available to the agent
SKILL.md
1,322 tokensWhen the skill is activated
Reference documents
835 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Configuration
- Target Modes
- Phase 1: Target Resolution
- Phase 2: Context Collection
- Phase 3: Review Planning
- Phase 4: Sub-Agent Review
- Phase 5: Finding Consolidation
- Phase 6: Final Response
- Review Discipline
Scripts executed separately
scripts/review-context.py
Files
SKILL.mdcore6,134 bytesSKILL.mdcore6,134 bytesreferences/output-format.mddoc1,830 bytesreferences/reviewer-template.mddoc1,895 bytesscripts/review-context.pyruns9,952 bytes
Read SKILL.md
# Review SPD
You are executing the **Review SPD** workflow: a findings-first review of changed code. Identify bugs, regressions, and behavior risks introduced by the changes. Do not turn this into a style review or a broad summary.
## Configuration
| Item | Default | Purpose |
|:-----|:--------|:--------|
| Context script | `scripts/review-context.py` relative to this Review SPD skill directory | Collect stable git context |
| Default target | Uncommitted changes | Working tree + staged changes |
| Commit range default | Last 3 days | Only when the user requests commit/date review without dates |
| PR base | Auto-detect `origin/main`, `origin/master`, then remote default branch | Base for branch-vs-main review |
| Output style | Findings first | Findings by severity before summaries |
View the complete source on GitHubspec-driven-develop
When your agent uses it
Automates pre-development workflow for large-scale complex tasks. Use when the user mentions "rewrite", "migrate", "overhaul", "refactor entire project", "transform", "rebuild in [language]", "spec-driven", or describes any large-scale project transformation that requires planning before coding. Also triggers on Chinese keywords: "改造", "重写", "迁移", "重构", "大规模", "规范驱动". Performs full project analysis, task decomposition, documentation generation, project-level instruction and native memory surface resolution, progress tracking setup, and then executes the plan within the same session. Keeps Issues as task-tracking units while batching related implementation into coherent reviewable PRs.
What it loads into context
Frontmatter
176 tokensAlways available to the agent
SKILL.md
4,551 tokensWhen the skill is activated
Reference documents
16,490 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Configuration
- Before You Begin: Cross-Conversation Continuity Check
- Phase 0: Quick Intent Capture
- Phase 1: Deep Project Analysis
- Phase 2: Intent Refinement & Confirmation
- Phase 3: Task Decomposition
- Phase 4: Progress Tracking Documentation
- Phase 5: Confirm & Execute
- Phase 6: Archive
Files
SKILL.mdcore20,713 bytesreferences/adaptive-control.mddoc9,418 bytesreferences/behavioral-rules.mddoc7,118 bytesreferences/github-integration.mddoc15,399 bytesreferences/parallel-protocol.mddoc9,492 bytesreferences/super-philosophy.mddoc5,878 bytesreferences/templates/analysis.mddoc5,288 bytesreferences/templates/archive.mddoc1,767 bytesreferences/templates/governance.mddoc3,262 bytesreferences/templates/plan.mddoc6,537 bytesreferences/templates/progress.mddoc7,406 bytes
Read SKILL.md
# Spec-Driven Develop
You are executing the **Spec-Driven Development** workflow — a seven-phase pipeline (Phases 0-6) for large-scale complex tasks. Complete preparation phases (analysis, planning, progress setup), then execute the plan — all within a single session.
**Behavioral rules**: `references/behavioral-rules.md` — read and follow them in every phase; they are non-negotiable.
## Configuration
| Path | Default Value | Purpose |
|:-----|:--------------|:--------|
| Analysis output | `docs/analysis/` | Phase 1 analysis documents |
| Plan output | `docs/plan/` | Phase 3 planning documents |
| Progress output | `docs/progress/` | Phase 4 tracking documents (incl. MASTER.md) |
| Instruction surfaces | Resolved per project | Project-level constraints for agents (see Phase 4) |View the complete source on GitHubSkills included
- deep-discuss
- review-spd
- spec-driven-develop
Repository facts
- License
- MIT
- Created
- Mar 21, 2026
- Last pushed
- Jul 26, 2026
- Forks
- 101
- Open issues
- 1
- Project activity
- Slowing
Rank over the last 12 weeks
Now #898 · best #583 · down 192 in 30 days
- #872 on Oct 30
- #875 on Oct 31
- #879 on Nov 1
- #886 on Nov 2
- #893 on Nov 3
- #898 since Nov 4
37 earlier periods
- #619 on Aug 1
- #554 on Aug 5
- #559 on Aug 9
- #583 on Aug 10
- #582 on Aug 12
- #593 on Aug 13
- #588 on Aug 16
- #592 on Aug 17
- #601 on Aug 20
- #607 on Aug 21
- #583 on Aug 22
- #619 on Aug 24
- #613 on Aug 26
- #642 on Aug 28
- #598 on Aug 30
- #622 on Aug 31
- #611 on Sep 4
- #653 on Sep 8
- #639 on Sep 13
- #664 on Sep 14
- #645 on Sep 25
- #720 on Sep 29
- #660 on Oct 1
- #684 on Oct 4
- #687 on Oct 5
- #698 on Oct 6
- #706 on Oct 7
- #746 on Oct 8
- #715 on Oct 9
- #733 on Oct 14
- #726 on Oct 15
- #733 on Oct 16
- #755 on Oct 21
- #743 on Oct 23
- #845 on Oct 25
- #865 on Oct 28
- #866 on Oct 29
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 4, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 4 notes
plugins/spec-driven-develop/agents/code-reviewer.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedplugins/spec-driven-develop/agents/task-executor.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedplugins/spec-driven-develop/skills/review-spd/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedplugins/spec-driven-develop/agents/code-reviewer.md:1Plugin-wide analysis incomplete; see repository notes
- No broad tool permissions
- No dangerous shell commands
- No hidden or obfuscated text
- No instruction overrides
- 2 executable scriptsin 1 file: plugins/spec-driven-develop/skills/review-spd/scripts/review-context.py:1
- 2 references to secretsin 1 file: plugins/spec-driven-develop/skills/spec-driven-develop/references/super-philosophy.md:81
- No requests to vote in Hot
Show all 40 signals by file
.claude-plugin/marketplace.json
- Network accessline 16
"name": "zhu1090093659" }, "homepage": "https://github.com/zhu1090093659/spec_driven_develop", - Network accessline 17
}, "homepage": "https://github.com/zhu1090093659/spec_driven_develop", "repository": "https://github.com/zhu1090093659/spec_driven_develop", - Network accessline 18
"homepage": "https://github.com/zhu1090093659/spec_driven_develop", - Network accessline 19
"repository": "https://github.com/zhu1090093659/spec_driven_develop",
plugins/spec-driven-develop/.claude-plugin/plugin.json
- Network accessline 6
"author": { "name": "zhu1090093659", "url": "https://github.com/zhu1090093659" - Network accessline 7
"name": "zhu1090093659", "url": "https://github.com/zhu1090093659" }, - Network accessline 8
"url": "https://github.com/zhu1090093659" - Network accessline 9
}, "homepage": "https://github.com/zhu1090093659/spec_driven_develop", "repository": "https://github.com/zhu1090093659/spec_driven_develop", - Network accessline 10
"homepage": "https://github.com/zhu1090093659/spec_driven_develop", - Network accessline 11
"repository": "https://github.com/zhu1090093659/spec_driven_develop",
plugins/spec-driven-develop/skills/review-spd/scripts/review-context.py
plugins/spec-driven-develop/skills/spec-driven-develop/references/github-integration.md
- Network accessline 144
--- _Managed by [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 144
--- _Managed by [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 145
_Managed by [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 145
_Managed by [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 320
--- _Part of [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 320
--- _Part of [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 321
_Part of [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_ - Network accessline 321
_Part of [Spec-Driven Develop](https://github.com/zhu1090093659/spec-driven-develop) workflow_
plugins/spec-driven-develop/skills/spec-driven-develop/references/super-philosophy.md
plugins/spec-driven-develop/skills/spec-driven-develop/references/templates/progress.md
- Network accessline 27
## GitHub Resources - **Project Board**: https://github.com/users/{user}/projects/{num} _(GITHUB_FULL only)_ - Network accessline 27
## GitHub Resources - **Project Board**: https://github.com/users/{user}/projects/{num} _(GITHUB_FULL only)_ - Network accessline 28
- **Project Board**: https://github.com/users/{user}/projects/{num} _(GITHUB_FULL only)_ - Network accessline 28
- **Project Board**: https://github.com/users/{user}/projects/{num} _(GITHUB_FULL only)_ - Network accessline 42
| Phase | Name | Milestone URL | Open | Closed | Total | |:------|:-----|:-------------|-----:|-------:|------:| | 1 | | https://github.com/{owner}/{repo}/milestone/1 | N | 0 | N | - Network accessline 42
| Phase | Name | Milestone URL | Open | Closed | Total | |:------|:-----|:-------------|-----:|-------:|------:| | 1 | | https://github.com/{owner}/{repo}/milestone/1 | N | 0 | N | - Network accessline 43
|:------|:-----|:-------------|-----:|-------:|------:| | 1 | | https://github.com/{owner}/{repo}/milestone/1 | N | 0 | N | | 2 | | https://github.com/{owner}/{repo}/milestone/2 | N | 0 | N | - Network accessline 43
|:------|:-----|:-------------|-----:|-------:|------:| | 1 | | https://github.com/{owner}/{repo}/milestone/1 | N | 0 | N | | 2 | | https://github.com/{owner}/{repo}/milestone/2 | N | 0 | N | - Network accessline 44
| 1 | | https://github.com/{owner}/{repo}/milestone/1 | N | 0 | N | - Network accessline 44
| 1 | | https://github.com/{owner}/{repo}/milestone/1 | N | 0 | N | - Network accessline 45
| 2 | | https://github.com/{owner}/{repo}/milestone/2 | N | 0 | N | - Network accessline 45
| 2 | | https://github.com/{owner}/{repo}/milestone/2 | N | 0 | N | - Network accessline 78
## Phase Checklist - [ ] Phase 1: <name> (0/N tasks) — [milestone](https://github.com/{owner}/{repo}/milestone/1) - Network accessline 78
## Phase Checklist - [ ] Phase 1: <name> (0/N tasks) — [milestone](https://github.com/{owner}/{repo}/milestone/1) - Network accessline 79
- [ ] Phase 1: <name> (0/N tasks) — [milestone](https://github.com/{owner}/{repo}/milestone/1) - Network accessline 79
- [ ] Phase 1: <name> (0/N tasks) — [milestone](https://github.com/{owner}/{repo}/milestone/1) - Network accessline 80
- [ ] Phase 2: <name> (0/N tasks) — [milestone](https://github.com/{owner}/{repo}/milestone/2) - Network accessline 80
- [ ] Phase 2: <name> (0/N tasks) — [milestone](https://github.com/{owner}/{repo}/milestone/2)
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
No combined signals at this commit.
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Native | Manifest .claude-plugin/marketplace.json | .claude/skills/<skill-name>/ |
| Codex | Native | Manifest AGENTS.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md plugins/spec-driven-develop/skills/deep-discuss/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md plugins/spec-driven-develop/skills/deep-discuss/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md plugins/spec-driven-develop/skills/deep-discuss/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md plugins/spec-driven-develop/skills/deep-discuss/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
Explore alternatives and comparisons
Add this badge to your README
It updates every night and links to this page.
[](https://hotskills.dev/skill/zhu1090093659-spec_driven_develop/)