用途:从 YouTrack 问题卡片生成规范(spec)和可选的实现计划,内容与真实代码库对齐,避免通用化。
主要能力:
- 识别卡片 ID 与模式:spec-only 或 spec-and-plan;未给出 ID 时先询问;模式不明确时默认 spec-and-plan。
- 获取 YouTrack 数据:运行
yt issues show <card-id>、yt issues comments list <card-id>、yt issues related <card-id>,必要时再查相关卡片的yt issues show <related-id>。 - 理解代码库:阅读 AGENTS.md、CLAUDE.md、.claude/CLAUDE.md、README.md 等,按卡片主题搜索相关代码、测试、技术栈与命名约定。
- 写 spec:保存为
<card-id>-spec.md,含 Background、What We're Building、Technical Context、Acceptance Criteria、Out of Scope、Open Questions、Notes。 - 写 plan:保存为
<card-id>-plan.md,含 Overview、Files to Create / Modify、按阶段划分的 Tasks、Testing Strategy、Definition of Done。
使用方式:在对话中提到 YouTrack 卡片 ID 即可触发。先确认模式,抓取卡片数据,探索仓库,按需提出 2–4 个澄清问题(每次一个),再写 spec;spec 完成后再针对实现决策提问,最后写 plan。若无法抓取数据(如 yt 未认证、问题不存在),会明确说明并基于已有信息生成。
适用场景:需要从 YouTrack 卡片落地为可执行开发计划的团队或 AI 代理,尤其适用于任务分散、依赖复杂或需要结合现有代码模式的工程。
限制:依赖 yt 命令行工具和已认证的 YouTrack 环境;计划质量受卡片信息与代码库可读性影响;未提供关于收费、价格、平台支持范围等额外信息。