Hacktoberfest 2026:維護者為十月標記出來的 issue,仍然開放、適合新手。 瀏覽 Hacktoberfest issue

[Feature]: Deprecate the core taskstoissues command

已關閉
#4,422 0 則留言 1 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

已經有一個關聯 PR 被合併了。

  • #4879 來自 @rohanz —— 已合併

評估

難度
4/5
預估耗時
3-5 天
新手友好度
55/100
Issue 類型
功能
描述清晰度
基本清楚
活躍度
活躍
技術堆疊
github, python
領域
cli, documentation

研究方向

#4421 發布後,從核心 /speckit.taskstoissues CLI 入口點開始,檢查命令清單和面向使用者的文件。在新增警告之前,驗證現有行為、安全性檢查、去重,以及 before_taskstoissues/after_taskstoissues hooks。完成標準是命令仍然正常運作、遷移命令和棄用狀態已有文件說明,且相依工作可以針對該擴充功能。

由索引模型根據 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
星號
140k
分支
12.6k
平均合併
1 天 11 小時
30 天內合併 PR
184

環境準備

在 Codespaces 中開啟

在瀏覽器裡用你自己的 GitHub 帳號啟動這個專案的開發容器。

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

github/spec-kit 的其他 Issue

查看 github/spec-kit 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。