[Feature]: Deprecate the core taskstoissues command
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 55/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- github, python
- 领域
- cli, documentation
调研方向
#4421 发布后,从核心 /speckit.taskstoissues CLI 入口点开始,检查命令清单和面向用户的文档。在添加警告之前,验证现有行为、安全检查、去重,以及 before_taskstoissues/after_taskstoissues 钩子。完成标准是命令仍然有效,迁移命令和弃用状态已有文档说明,并且依赖此工作的后续工作可以面向该扩展。
由索引模型根据 Issue 内容生成。
描述
Problem Statement
/speckit.taskstoissues is currently presented as a core Spec Kit command even though it performs GitHub-specific issue-tracker integration. Once the bundled GitHub Issues extension from #4421 is available, users should be guided toward the extension before the core command is removed.
Removing the command without a deprecation period would provide no transition window for existing projects, automation, presets, or dependent extensions.
Proposed Solution
After #4421 has shipped, mark the core /speckit.taskstoissues command as deprecated while preserving its behavior for this stage.
When invoked, the command should display a concise warning that:
- The core command is deprecated and will be removed in a future minor release.
- Its replacement is the bundled
github-issuesextension. - Users can migrate with:
specify extension add github-issues
/speckit.github-issues.taskstoissues
The deprecation must not automatically install or enable the extension. Existing command behavior, safety checks, deduplication, and lifecycle hooks should remain unchanged until the removal stage.
Update user-facing command inventories and documentation to distinguish the deprecated core command from the recommended extension command.
Alternatives Considered
- Deprecate before adding the extension: Rejected because the warning would point users toward a replacement that is not yet available.
- Silently document the migration without an invocation warning: Easy to miss for users who do not regularly read release notes.
- Remove the command in the same release: Provides no practical migration window for existing users or dependent extensions.
Component
Specify CLI (initialization, commands)
AI Agent (if applicable)
All agents
Use Cases
- Existing users learn how to migrate while their current command still works.
- Preset and extension authors have time to update dependencies and hook references.
- Teams can schedule the extension installation before a later upgrade removes the core command.
Acceptance Criteria
- This issue is implemented only after #4421 has shipped.
- Invoking the core
speckit.taskstoissuescommand displays an actionable deprecation warning. - The warning identifies
speckit.github-issues.taskstoissuesas the replacement and includes the installation command. - The deprecated core command retains its existing behavior.
-
before_taskstoissuesandafter_taskstoissueshooks continue to work. - Core command documentation and inventories clearly mark the command as deprecated.
- Migration documentation covers existing projects, integrations, presets, and extensions.
- #4370 and other dependent work can update their dependency target to the extension command.
- The change is included in a minor release after the extension release.
Additional Context
This is stage 2 of the three-stage migration:
- #4421 adds the bundled extension while retaining core behavior.
- This issue deprecates the core command.
- A follow-up issue will remove it from core after the deprecation window.
Related discussion: #4370, especially https://github.com/github/spec-kit/issues/4370#issuecomment-5525946904.
- 主要语言
- Python
- 星标
- 138k
- 派生
- 12.4k
- 平均合并
- 3 天 4 小时
- 30 天内合并 PR
- 154
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
github/spec-kit 的其他 Issue
-
enhancement needs-triage
难度 2/5 1-3 小时 新手友好度 68/100
-
enhancement needs-triage
难度 2/5 1-3 小时 新手友好度 74/100
-
enhancement needs-triage
难度 2/5 1-3 小时 新手友好度 68/100
-
难度 2/5 1-3 小时 新手友好度 84/100
-
enhancement needs-triage triage-can-wait
难度 2/5 1-3 小时 新手友好度 76/100
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 75/100
anthropics/skills#1811 · 1 条评论 ·
-
难度 2/5 1-3 小时 新手友好度 75/100
speaches-ai/speaches#678 ·
-
bug
难度 2/5 1-3 小时 新手友好度 75/100
datalayer/mcp-compose#42 ·
-
难度 2/5 1-3 小时 新手友好度 75/100
conda-forge/spacy-feedstock#177 ·
-
难度 2/5 1-3 小时 新手友好度 70/100
UKGovernmentBEIS/inspect_evals#2523 ·