aisee:change-plan

aisee:change-plan — OpenSpec Change 边界规划

将已确认需求、轻量修复、技术调研或项目事实映射为边界清晰、可独立交付的 OpenSpec changes。每个输出 change 都应足够小，可以用 /opsx:new 创建，并在实现前按所选 schema 的 artifact 顺序补齐内容。

职责边界

本 skill 负责：

• 选择每个 change 的 schema。
• 在输出 /opsx:new 前检查项目当前 schema 来源：change metadata、openspec/config.yaml、项目内 openspec/schemas/ 或 OpenSpec 默认 spec-driven。
• 规划 change 边界、依赖顺序和并行关系。
• 使用 Mermaid 语法块输出依赖顺序和并行关系，作为长期可读性 contract。
• 输出 source-map seed，仅当所选 schema 生成 source-map.md。
• 输出可复制的 /opsx:new "<change>" --schema <schema> 命令，并把它视为后续 author 的 schema metadata 合同。
• 保存 change plan 到 aisee/docs/change-plan/。

上游如果存在 design-spec、design-assets、spec-migrate、reflect 或 hw:* 输入，只能按需作为边界线索使用；它们不是默认新功能 happy path 的必经节点。

本 skill 不负责：

• 重新做业务模块划分或重新生成需求。
• 把 SRS 模块名、页面类型、技术层、schema artifact 或实施任务直接当作 change。
• 为上游对象分配额外编号状态。
• 生成或补齐任何 change artifact 正文。
• 默认优先使用项目当前 schema；项目没有额外约束时回落到官方 spec-driven。

输入

用户提供以下任意一种输入：

• 原始需求描述。
• ticket / issue 引用。
• 既有需求文档路径，包括 aisee:srs 输出的 SRS。
• 可选配套输入：aisee:spec-migrate、aisee:design-spec、aisee:design-assets。

可选参数：

• --strategy vertical|risk|parallel，默认 vertical。
• --granularity fine|medium|coarse，默认 medium。
• --schema auto|<name>，默认 auto。
• --max-changes <N>，默认 8。
• --single-if-small。

Reference Loading

只按需读取 references，不要一次性展开全部文件：

• 先读 references/input-boundary-rules.md。
• schema 不明确时读 references/schema-selection-rules.md。
• 划分多个 changes 或依赖复杂时读 references/change-boundary-algorithm.md。
• 只有所选 schema 生成 source-map.md 时读 references/source-map-rules.md。
• 最终写文件前读 references/output-template.md。

阶段 1 — 读取项目上下文

静默收集输入和项目事实：

cat <input-file-path> 2>/dev/null || echo "File not found"
cat openspec/config.yaml 2>/dev/null || echo "No config found"
openspec list --json 2>/dev/null || ls openspec/changes/ 2>/dev/null || echo "No existing changes found"
ls openspec/changes/archive/ 2>/dev/null | head -20
cat AGENTS.md 2>/dev/null | head -120

AGENTS.md 是主入口；CLAUDE.md 只作为旧项目兼容 fallback，不主动作为新项目上下文读取。