issue

用途

issue 是 local-life-manager 技能集中的一个命令，用于通过自然对话创建独立的工作项（work item）。它借助 AI 辅助判断工作项类型，适合需要跟踪待办工作、需要探索调研或记录缺陷的场景。

主要能力

通过自然语言对话创建工作项，AI 根据描述关键词自动判断类型。
支持三种工作项类型：
- TASK：需要完成的工作。检测关键词包括 implement、create、add、build、write、set up。
- SPIKE：时间盒限定的探索调研。检测关键词包括 compare、vs、should we、evaluate、explore、research、feasibility。
- BUG：损坏或错误的内容。检测关键词包括 fix、broken、incorrect、outdated、wrong、error。
可与项目 spec 集成，将工作项关联到具体需求条目，并更新 spec 中的状态标记。

使用方式

命令用法示例：

/issue                                    # 启动对话
/issue "Implement authentication"         # AI 检测为：TASK
/issue "Compare GraphQL vs REST"          # AI 检测为：SPIKE
/issue "Broken link in project-brief"     # AI 检测为：BUG
/issue --project coordinatr               # 为特定项目创建

执行流程：

收集上下文：如果没有描述，询问“What needs to be done?”；如果没有项目，询问“Which project?”。
检测类型：分析描述关键词并给出检测结果，例如“This sounds like a TASK. Create as issue 002? (yes / spike / bug)”。
确定下一个工作项编号：

ls ideas/[project]/issues/ | grep -E '^[0-9]{3}-' | sort -n | tail -1

询问 spec 章节：检查项目是否有 spec（Glob: spaces/[project]/docs/specs/*.md）。如果存在，询问“Which spec section does this implement?”，选项包括具体章节或 none（独立任务）。
创建工作项文件。
如果工作项实现了某个 spec 章节，更新 spec 中的内联状态标记（例如将 ⏳ 改为 🚧）。/complete 命令会在完成时将其标记为 ✅。
下一步建议：对于 TASK/BUG，建议使用 /plan ### 创建实现阶段；对于 SPIKE，建议使用 /plan ### 创建探索计划。

文件结构

ideas/[project]/issues/
└── 001-implement-auth/
    ├── TASK.md       # 或 SPIKE.md 或 BUG.md
    ├── PLAN.md       # 由 /plan 创建
    └── WORKLOG.md    # 进度跟踪

各类型文件模板：

TASK.md：

---
status: open
created: YYYY-MM-DD
implements: docs/specs/required-features.md#authentication  # 独立任务时留空
depends_on: []
---

# TASK-###: [Title]

## Description

[What needs to be done and why]

## Implements

**Spec Section:** [docs/specs/required-features.md#authentication](../../spaces/[project]/docs/specs/required-features.md#authentication)

**Requirements from spec:**
- [Requirement 1 from spec]
- [Requirement 2 from spec]

## Acceptance Criteria

- [ ] Criterion 1
- [ ] Criterion 2

## Context

[Background, relevant decisions, technical notes]

SPIKE.md：

---
status: open
created: YYYY-MM-DD
timebox: X hours
---

# SPIKE-###: [Title]

## Questions

- Question 1?
- Question 2?

## Approaches to Explore

1. Approach A
2. Approach B

## Findings

(filled after exploration)

## Recommendation

(filled after exploration)

BUG.md：

---
status: open
created: YYYY-MM-DD
---

# BUG-###: [Title]

## What's Broken

[Description of the problem]

## Location

[File paths, URLs, etc.]

## Expected Behavior

[What should happen]

## Steps to Reproduce

1. Step 1
2. Step 2

状态值

状态	含义
open	未开始
in_progress	进行中
blocked	等待中
complete	已完成

Spec 集成与任务范围

一个 TASK 对应一条需求条目。TASK 应当是原子且可独立交付的：

恰好实现一条 spec 需求。
可以独立推送到 main。
完成时更新一个 ⏳ → ✅ 标记。

示例：

# Spec line items (each becomes a TASK)
- ⏳ User registration with email/password    ← TASK-002
- ⏳ User login with JWT token                ← TASK-003
- ⏳ Password reset flow                      ← TASK-004

不要创建：“TASK: Implement Authentication”（过于宽泛）。应当创建：“TASK: User registration endpoint”（一条需求）。

implements 字段指向具体需求：

implements: docs/specs/required-features.md#user-registration-with-email-password

这在工作项与其满足的确切需求之间建立了直接链接。

工作流

/spec → /issue → /plan → (work) → /complete
         ↓
   implements: spec section

适用场景

需要跟踪待办工作、探索调研或记录缺陷时。
希望将工作项与项目 spec 需求关联并跟踪状态时。

限制

资料未提供关于收费、价格、平台支持范围或效果保证的信息。