v2.2.1 — init 一次补齐运行上下文

v2.2.1

• init 命令第 6 步扩展为「选迭代并补全运行上下文」:context init 一次喂齐 项目/迭代/用户
• specstoissues 上下文自检注明:跑过 init 后该兜底通常可跳过

v2.2.0 — /speckit.pingcode.init 交互式初始化

v2.2.0 — /speckit.pingcode.init 交互式初始化

新增一键初始化命令:不再手动复制模板、猜测类型/状态名。

Added

• /speckit.pingcode.init 交互式初始化命令:
  • 认证自检(未认证引导 pingcode auth login)
  • 选择项目(set-current-project 解析并填充字典)
  • 基于项目实际字典选择映射类型(spec_artifact/story_artifact,可空)
  • 选择收尾状态名(status_mapping.completed)与优先级名(priority_mapping p1/p2/p3)
  • 选择迭代:固定到配置,或留空走运行时解析链
  • 直接生成 pingcode-config.yml;已存在配置逐键展示差异,确认覆盖(备份 .bak)
  • 参数:--project <名称或ID> 跳过项目选择;--force 覆盖不询问;--dry-run 只预览
• discover-context 保留为字典重探与配置片段工具;README 快速开始改为 init 优先

安装

specify extension add pingcode \
  --from https://github.com/HJXArthurAtlas/Spec-Kit-PingCode/releases/download/v2.2.0/pingcode-2.2.0.zip

Full Changelog: v2.1.0...v2.2.0

v2.1.0 — 映射收敛:只有 spec 与 User Story 两级建卡

v2.1.0 — 映射收敛:只有 spec 与 User Story 两级建卡

BREAKING:mapping.task_artifact 移除。任务与 Phase 不再创建工作项,一律以
checklist 文本折叠进所属卡描述。若从 2.0.0 升级,请从配置中删除 task_artifact、
defaults.task、status_mapping.pending/in_progress,并删除旧 pingcode-mapping.json 重建。

Changed

• BREAKING:映射收敛为 spec 与 User Story 两级——任务与 Phase 不再创建工作项,
  一律以 checklist 文本折叠进所属卡描述:story 卡嵌自己的任务清单(按 Phase 分组),
  spec 卡嵌跨故事任务清单;环境变量 SPECKIT_PINGCODE_TASK_ARTIFACT 移除
• 卡片描述构成:配置 story_artifact 时 spec 卡只保留非 User Story 正文,
  章节内容各自进章节卡;未配置时全文(含章节)并入 spec 卡
• 父卡关联按顶层卡类型泛化:故事类卡选特性挂靠,特性类卡选史诗挂靠(均可跳过);
  章节卡固定挂 spec 卡下
• status_mapping 精简为仅 completed(中间状态不由扩展流转);
  环境变量 SPECKIT_PINGCODE_STATUS_PENDING/IN_PROGRESS 移除
• sync-status 精简为卡片收尾:某张卡关联任务全部 [x] → 流转该卡到完成态
  (spec-story 模式逐 story 卡判断,spec-only 模式判断 spec 卡);
  逐任务流转与差异报告移除,日志改为逐卡收尾记录
• pingcode-mapping.json 移除 tasks[]/minimal/summary,mode 取值改为
  spec-only | spec-story;任务归属由 sync-status 直接从 tasks.md 解析

Removed

• 任务工作项创建流程与极简模式概念(任务永远只是卡内 checklist)

安装

specify extension add pingcode \
  --from https://github.com/HJXArthurAtlas/Spec-Kit-PingCode/releases/download/v2.1.0/pingcode-2.1.0.zip

Full Changelog: v2.0.0...v2.1.0

v2.0.0 — 映射轴切换:User Story 章节取代 Phase

v2.0.0 — 映射轴切换:User Story 章节取代 Phase

BREAKING:mapping.phase_artifact 移除,代之以 mapping.story_artifact。
默认配置(单卡模式)行为与 1.x 一致;使用过 3 层模式或 SPECKIT_PINGCODE_PHASE_ARTIFACT
环境变量的项目需要按下方说明迁移;pingcode-mapping.json 结构有变,旧映射文件建议删除后重建。

Changed

• BREAKING:mapping.phase_artifact 移除,代之以 mapping.story_artifact —— 映射轴从
  TASKS.md 的 Phase 标题改为 SPEC.md 的 ### User Story N 章节。Phase 是实施阶段而非交付物,
  不再可映射为工作项,始终以分组 checklist 嵌入所属卡描述。
  环境变量 SPECKIT_PINGCODE_PHASE_ARTIFACT 更名为 SPECKIT_PINGCODE_STORY_ARTIFACT
• story_artifact 留空(默认)= 单卡模式,行为与旧版 2 层模式一致:整个 spec 一张
  spec_artifact 卡;设为类型名 = 按章节模式,每个 User Story 章节建一张卡,
  spec_artifact 可选作章节卡的父卡(建议留空或设更高需求类型如 "特性")
• pingcode-mapping.json 结构调整:story 单对象 + phases[] 嵌套任务 → 顶层 stories[]
  (单卡模式为单个 us_no: null 条目)+ spec_card + 顶层 tasks[](新增 us_no 字段);
  mode 取值改为 single | by-story,极简模式改由独立的 minimal 布尔字段表达
• sync-status 收尾逻辑改为逐卡:每张 story 卡在其关联任务(us_no 匹配)全部完成后流转;
  按章节模式的 spec 父卡不自动收尾

Added

• 按章节模式:任务行按 [US#] 标记路由到所属章节卡;无标记的跨故事任务
  (Setup/Foundational/Polish 等)挂 spec 父卡,无父卡时挂所选特性/史诗
• 按章节模式章节卡携带优先级:从章节标题尾注捕获 P1/P2/P3,经新增 priority_mapping
  (默认 高/中/低,环境变量 SPECKIT_PINGCODE_PRIORITY_P1/P2/P3)映射为项目优先级名;
  无编号章节回落 defaults.story.priority,仍未设置则不设优先级。映射文件 stories[]
  条目新增 priority 字段记录实际设置值

安装

specify extension add pingcode \
  --from https://github.com/HJXArthurAtlas/Spec-Kit-PingCode/releases/download/v2.0.0/pingcode-2.0.0.zip

Full Changelog: https://github.com/HJXArthurAtlas/Spec-Kit-PingCode/blob/master/CHANGELOG.md

v1.1.0 — story 支持 Epic/Feature 关联

新增

• specstoissues 支持 story 关联 Epic/Feature:创建 story 前交互选择史诗与特性,以 --parent 挂到特性下,呈现 史诗 → 特性 → 用户故事 完整层级;无特性时可直接挂史诗,也可选择不关联
• 新增 --epic / --feature 参数(按名称/identifier/id 精确匹配)跳过交互
• 补建模式下 story 已存在时跳过选择;映射文件 pingcode-mapping.json 结构不变
• --dry-run 创建计划回显关联关系;输出总结含关联行

其他

• 包含未单独发版的 1.0.1 变更:故障排除新增「仓库子目录里执行命令后上下文丢失」条目(pingcode CLI 缓存路径锚定 git 仓库根)

安装

specify extension add pingcode \
  --from https://github.com/HJXArthurAtlas/Spec-Kit-PingCode/releases/download/v1.1.0/pingcode-1.1.0.zip

v1.0.0 — PingCode Integration 扩展首次发布

spec-kit 的 PingCode 集成扩展(扩展 id: pingcode-cli)首次发布。

将 spec-kit 规格产物(SPEC.md + TASKS.md)转换为 PingCode 工作项层级,并把本地任务完成状态回写到 PingCode。基于 pingcode-cli 命令行工具,扩展本身零代码。

Added

• extension.yml 扩展清单(扩展 id pingcode-cli,命令注册、配置模板、after_tasks 钩子)
• /speckit.pingcode-cli.specstoissues:SPEC.md + TASKS.md → PingCode 工作项层级
  • 默认 2 层模式(story + task,Phase 嵌入描述);支持 3 层与极简模式
  • 迭代运行时解析链(参数 > 配置 > 上下文 > 自动发现/询问)
  • 幂等防护(补建/重建/中止)、429 限流重试、逐任务错误隔离
• /speckit.pingcode-cli.discover-context:项目类型/状态/迭代字典探查与配置片段生成
• /speckit.pingcode-cli.sync-status:本地勾选状态 → PingCode 状态流转,story 自动收尾,远端先行变更不回退(差异报告)
• pingcode-config.template.yml 配置模板与环境变量覆盖
• 映射产物 pingcode-mapping.json 与同步日志 pingcode-sync-log.json

安装

specify extension add pingcode-cli \
  --from https://github.com/HJXArthurAtlas/Spec-Kit-PingCode-CLI/releases/download/v1.0.0/pingcode-cli-1.0.0.zip

spec-kit 社区目录为 discovery-only(仅搜索发现、不支持按名安装),故始终通过 --from 指定 Release 归档安装。