initiative-architecture

用途

initiative-architecture 用于处理“MASSIVE”级别的工作请求——即规模超出单个 epic（功能领域）的任务。当一个请求需要跨多个 epic、在规划前需要大量研究、可能需要新基础设施或能力、耗时数周到数月、且存在大量待调查的未知项时，就应将其作为 initiative 来处理。该技能的目标是系统化地调查、记录并将庞大请求结构化为可恢复、可执行的计划。

核心原则是：记录一切。每个未知项都要有答案，每个决策都要被记录，每个假设都要被验证。架构必须能被一个全新的上下文恢复并继续。

技能开始时需声明：“I'm using initiative-architecture to plan this massive request. This will involve investigation, documentation, and structured decomposition.”

主要能力

该技能按五个阶段推进：

阶段 1：记录未知项（Document Unknowns） 创建 initiative 跟踪 issue，包含原始请求、目标、当前理解、未知项列表（按 Critical / Important / Nice-to-Know 分类）、研究 spike、决策日志、epic 结构和里程碑等占位区块。未知项分类：Critical 阻塞架构决策，需立即研究；Important 阻塞实现，需在 epic 前研究；Nice-to-Know 影响决策，可在实现期间研究。

阶段 2：研究 spike（Research Spikes） 为每个关键/重要未知项创建 spike issue，包含父 initiative、未知问题、时间盒、调查计划、发现、建议和所需决策。执行时要求限时、边做边记录、以建议收尾、更新 initiative 标记未知项已解决。完成后用 gh issue comment 记录发现摘要（答案、证据、建议、置信度、权衡），关闭 spike 并更新 initiative。

阶段 3：决策日志（Decision Log） 在 initiative issue 中维护决策日志，记录每个决策的日期、上下文、考虑过的选项（含优缺点）、最终决策、理由、影响及关联 spike。提供决策模板，包含可逆性（Easy/Hard/Irreversible）和相关依赖关系。

阶段 4：Epic 结构（Epic Structure） 研究 spike 完成后，将工作分组为 epic，定义每个 epic 的目标、依赖、预估 issue 数和关键交付物。创建 initiative 标签和 epic 标签，并为每个 epic 创建跟踪 issue（使用 epic-management 技能）。

阶段 5：里程碑规划（Milestone Planning） 创建交付里程碑，将 epic 分配到里程碑，建立工作顺序。使用 gh api 创建里程碑并设置截止日期。

使用方式

该技能通过 GitHub CLI（gh）命令操作 issue、标签和里程碑。主要命令包括：

创建 initiative 跟踪 issue：

gh issue create \
  --title "[Initiative] [NAME]: Architecture & Planning" \
  --label "initiative,planning" \
  --body "..."

创建 spike issue：

gh issue create \
  --title "[Spike] [INITIATIVE]: [UNKNOWN QUESTION]" \
  --label "spike,research,initiative-[NAME]" \
  --body "..."

更新 spike 发现并关闭：

gh issue comment [SPIKE_NUMBER] --body "..."
gh issue close [SPIKE_NUMBER]

创建标签：

gh label create "initiative-[NAME]" --color "6E40C9" \
  --description "Part of [INITIATIVE NAME] initiative"

创建里程碑：

gh api repos/{owner}/{repo}/milestones -X POST \
  -f title="[Initiative] Phase 1: [NAME]" \
  -f description="..." \
  -f due_on="YYYY-MM-DDTHH:MM:SSZ"

此外，技能包含可恢复性设计：initiative issue 必须始终包含足够的上下文恢复信息，包括如何继续、开放 spike 链接、决策日志、当前 epic 状态、当前阶段、下一步行动、关键文件和关键决策摘要。还支持通过 MCP memory 将 initiative 存入知识图谱：

mcp__memory__create_entities([{
  "name": "Initiative-[NAME]",
  "entityType": "Initiative",
  "observations": [...]
}])

适用场景

适用于需要多 epic 规划的超大型工作请求，例如示例中的“移动推送登录”initiative：用户请求“添加用户通过点击手机弹窗登录的能力”。该请求被拆解为：阶段 1 识别关键未知（是否存在移动应用、推送通知基础设施、认证系统）和重要未知（推送认证安全要求、需支持的平台）；阶段 2 创建四个 spike（移动应用状态调查、推送通知基础设施审查、认证系统分析、推送认证安全要求）；阶段 3 做出决策（需构建移动应用→React Native、使用 Firebase Cloud Messaging、通过推送的 magic link 配合 JWT）；阶段 4 定义五个 epic（移动应用基础、推送通知系统、推送认证流程、后端认证集成、测试与安全审计）；阶段 5 划分三个里程碑（应用+推送基础设施、认证实现、加固）。

限制

该技能依赖 GitHub CLI 和 GitHub issue/标签/里程碑体系。资料未提供对其他平台的支持说明。技能本身不执行实现，实现需通过 epic-management 技能按 epic 进行。资料未提供关于收费、价格或具体平台兼容性的信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制