Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

[Feature]: Deprecate the core taskstoissues command

未关闭
#4,422 0 条评论 1 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
github, python
领域
cli, documentation

调研方向

#4421 发布后,从核心 /speckit.taskstoissues CLI 入口点开始,检查命令清单和面向用户的文档。在添加警告之前,验证现有行为、安全检查、去重,以及 before_taskstoissues/after_taskstoissues 钩子。完成标准是命令仍然有效,迁移命令和弃用状态已有文档说明,并且依赖此工作的后续工作可以面向该扩展。

由索引模型根据 Issue 内容生成。

描述

enhancement needs-triage triage-nice-to-have
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-issues extension.
  • 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
  1. Existing users learn how to migrate while their current command still works.
  2. Preset and extension authors have time to update dependencies and hook references.
  3. 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.taskstoissues command displays an actionable deprecation warning.
  • The warning identifies speckit.github-issues.taskstoissues as the replacement and includes the installation command.
  • The deprecated core command retains its existing behavior.
  • before_taskstoissues and after_taskstoissues hooks 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:

  1. #4421 adds the bundled extension while retaining core behavior.
  2. This issue deprecates the core command.
  3. 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

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

github/spec-kit 的其他 Issue

查看 github/spec-kit 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。