Night Market 技能 — 移植自 claude-night-market/attune。如需完整体验（含智能体、钩子与命令支持），请安装 Claude Code 插件。

适用场景

• 规划阶段已完成之后
• 准备开始实施具体任务时
• 需要系统化执行并同步跟踪进度时
• 希望基于检查点进行阶段性验证时
• 执行存在依赖关系的任务列表时
• 需持续监控整体进展与开发速率时

不适用场景

• 尚无实施计划（请先使用 Skill(attune:project-planning)）
• 仍处于规划或设计阶段（须先完成规划阶段，再进入执行）
• 仅单个孤立任务（可直接执行，无需框架开销）
• 探索性编码或原型开发（建议采用聚焦式开发方式）

集成方式

启用 superpowers 时：

• 调用 Skill(superpowers:executing-plans) 实现系统化执行
• 调用 Skill(superpowers:systematic-debugging) 解决问题
• 调用 Skill(superpowers:verification-before-completion) 执行完成前验证
• 调用 Skill(superpowers:test-driven-development) 支持 TDD 工作流

未启用 superpowers 时：

• 作为独立执行框架运行
• 内置检查点验证机制
• 提供标准化的进度追踪模式

执行框架

执行前阶段

操作步骤：

1. 加载实施计划
2. 验证项目已初始化
3. 检查依赖项是否已安装
4. 审阅任务依赖图
5. 识别起始任务（即无前置依赖的任务）

校验项：

• ✅ 计划文件存在且格式有效
• ✅ 项目结构已初始化
• ✅ Git 仓库已配置
• ✅ 开发环境已就绪

任务执行循环

按依赖顺序逐个执行每个任务：

1. 执行前准备（PRE-TASK）
   - 验证前置依赖任务均已完结
   - 审阅验收标准
   - 创建特性分支（可选）
   - 设置当前任务上下文

2. 实施（TDD 循环）
   - 编写失败测试（RED）
   - 实现最小可行代码（GREEN）
   - 重构以提升质量（REFACTOR）
   - 重复上述步骤，直至全部验收标准满足

3. 验证（VALIDATE）
   - 所有测试是否通过？
   - 所有验收标准是否达成？
   - 代码质量检查是否通过？
   - 文档是否已更新？

4. 检查点（CHECKPOINT）
   - 立即标记该任务为“已完成”（严禁批量提交完成状态）
   - 更新执行状态
   - 上报当前进度
   - 识别阻塞项

任务完成规范：每项任务完成后，必须立即调用 TaskUpdate(taskId: "X", status: "completed") —— 绝不可推迟至会话结束时统一处理。

验证方式：运行 pytest -v 确认所有测试通过。

执行后阶段

操作步骤：

1. 验证所有任务均已完成
2. 运行完整测试套件
3. 检查代码质量指标
4. 生成执行完成报告
5. 为部署/发布做准备

终端阶段说明

此为 attune 工作流的最终阶段。执行完成后不会自动延续至后续阶段，工作流在此终止。与头脑风暴、需求定义及规划阶段不同，执行阶段不会自动触发任何后续阶段。

任务执行模式

TDD 工作流

RED 阶段：

# 编写一个预期失败的测试
def test_user_authentication():
    user = authenticate("user@example.com", "password")
    assert user.is_authenticated
# 运行测试 → 失败（功能尚未实现）

验证方式：运行 pytest -v 确认测试通过。

GREEN 阶段：

# 实现最简代码以使测试通过
def authenticate(email, password):
    # 最简实现
    user = User.find_by_email(email)
    if user and user.check_password(password):
        user.is_authenticated = True
        return user
    return None
# 运行测试 → 通过

验证方式：运行 pytest -v 确认测试通过。

REFACTOR 阶段：

# 提升代码质量
def authenticate(email: str, password: str) -> Optional[User]:
    """使用邮箱和密码对用户进行身份认证。"""
    user = User.find_by_email(email)
    if user is None:
        return None

    if not user.check_password(password):
        return None

    user.mark_authenticated()
    return user
# 运行测试 → 依然通过

验证方式：运行 pytest -v 确认测试通过。

检查点验证

质量门禁（Quality Gates）：

- [ ] 所有验收标准均已满足
- [ ] 所有测试通过（单元测试 + 集成测试）
- [ ] 代码已通过 Lint 检查（无警告）
- [ ] 类型检查通过（如适用）
- [ ] 文档已更新
- [ ] 其他组件未出现回归问题

验证方式：运行 pytest -v 确认测试通过。

自动化检查：

# 运行质量门禁检查
make lint          # Lint 检查通过
make typecheck     # 类型检查通过
make test          # 所有测试通过
make coverage      # 覆盖率达标

验证方式：运行 pytest -v 确认测试通过。

进度追踪

执行状态

保存至 .attune/execution-state.json：

{
  "plan_file": "docs/implementation-plan.md",
  "started_at": "2026-01-02T10:00:00Z",
  "last_checkpoint": "2026-01-02T14:30:22Z",
  "current_sprint": "Sprint 1",
  "current_phase": "Phase 1",
  "tasks": {
    "TASK-001": {
      "status": "complete",
      "started_at": "2026-01-02T10:05:00Z",
      "completed_at": "2026-01-02T10:50:00Z",
      "duration_minutes": 45,
      "acceptance_criteria_met": true,
      "tests_passing": true
    },
    "TASK-002": {
      "status": "in_progress",
      "started_at": "2026-01-02T14:00:00Z",
      "progress_percent": 60,
      "blocker": null
    }
  },
  "metrics": {
    "tasks_complete": 15,
    "tasks_total": 40,
    "completion_percent": 37.5,
    "velocity_tasks_per_day": 3.2,
    "estimated_completion_date": "2026-02-15"
  },
  "blockers": []
}

验证方式：运行 pytest -v 确认测试通过。

进度报告

每日站会（Daily Standup）：

# 每日站会 - [日期]

## 昨日完成
- ✅ [任务名称] ([耗时])
- ✅ [任务名称] ([耗时])

## 今日计划
- 🔄 [任务名称] ([进度]%)
- 📋 [任务名称] （待启动）

## 阻塞项
- [阻塞描述] 或 无

## 进度指标
- 冲刺进度：[X/Y] 项任务（[%]%）
- [状态说明]

验证方式：运行对应命令并添加 --help 参数，确认其可用性。

冲刺报告（Sprint Report）：

# 冲刺 [N] 进度报告

**时间范围**：[起始日期] - [结束日期]  
**目标**：[冲刺目标]

## 已完成（[X] 项任务）
- [任务列表]

## 进行中（[Y] 项任务）
- [任务名称] ([进度]%)

## 已阻塞（[Z] 项任务）
- [任务名称]：[阻塞原因]

## 燃尽图（Burndown）
- 第 1 天：剩余 [N] 项任务  
- 第 5 天：剩余 [M] 项任务（[状态]）  
- 预估完成日期：[日期]（[距今天数]）

## 风险项
- [风险描述] 或 未识别到风险

验证方式：运行对应命令并添加 --help 参数，确认其可用性。

阻塞项管理

阻塞项识别

常见阻塞类型：

• 无法快速修复的失败测试
• 缺失依赖项或 API 接口
• 需进一步调研的技术未知点
• 资源不可用（如人力、环境、权限）
• 需求范围模糊不清

系统化调试

遇到阻塞时，应应用如下调试框架：

1. 复现问题（Reproduce）：构建最小可复现用例
2. 提出假设（Hypothesize）：列举可能成因
3. 验证假设（Test）：逐一验证各假设
4. 解决问题（Resolve）：实施修复或临时方案
5. 记录归档（Document）：将解决方案存档供后续参考

升级处理（Escalation）

何时需升级：

• 阻塞持续超过 2 小时
• 涉及架构级变更
• 影响关键路径
• 需利益相关方决策

升级模板：

## 阻塞项：[TASK-XXX] - [问题简述]

**现象**：[当前表现]

**影响范围**：[受影响的任务/时间线]

**已尝试方案**：
1. [方案 1] — [结果]
2. [方案 2] — [结果]

**建议路径**：[推荐后续行动]

**待决策事项**：[需明确的具体决策点]

验证方式：运行对应命令并添加 --help 参数，确认其可用性。

质量保障

完成定义（Definition of Done）

一项任务视为完成，当且仅当满足以下全部条件：

• ✅ 所有验收标准均已达成
• ✅ 已编写全部所需测试且全部通过
• ✅ 已完成代码评审（自评或同行评审）
• ✅ Lint 检查通过，无任何警告
• ✅ 类型检查通过（如适用）
• ✅ 相关文档已更新
• ✅ 无已知回归问题
• ✅ 已部署至预发布环境（如适用）

测试策略

测试金字塔（Test Pyramid）：

**验证方式：** 运行 `pytest -v` 确认测试通过。
     /
    /E2E      数量少、执行慢、成本高
   /------
  /  INT      数量适中、执行中等速度
 /----------
/   UNIT      数量多、执行快、成本低

验证方式：运行对应命令并添加 --help 参数，确认其可用性。

按任务粒度：

• 单元测试：覆盖单个函数或类
• 集成测试：覆盖组件间交互逻辑
• E2E 测试：覆盖完整用户流程（面向用户的功能必需）

速率追踪

燃尽指标

每日追踪项：

• 剩余任务数
• 剩余故事点数
• 冲刺剩余天数
• 开发速率（每日完成任务数或故事点数）

计算公式：

**验证方式：** 运行 `pytest -v` 确认测试通过。
速率 = 已完成任务数 ÷ 已过去天数  
预估完成时间 = 剩余任务数 ÷ 速率  
是否按期？ = 预估完成时间 ≤ 冲刺截止日期

验证方式：运行对应命令并添加 --help 参数，确认其可用性。

速率调整策略

若进度超前：

• 纳入延伸任务（stretch tasks）
• 开展技术债清理
• 提升测试覆盖率
• 完善文档内容

若进度滞后：

• 定位根本原因（阻塞项、估算偏差等）
• 缩减范围（移除低优先级任务）
• 提升专注度（减少干扰）
• 申请额外支持或延长交付周期

相关技能

• Skill(superpowers:executing-plans) — 执行框架（如可用）
• Skill(superpowers:systematic-debugging) — 调试能力（如可用）
• Skill(superpowers:test-driven-development) — TDD 能力（如可用）
• Skill(superpowers:verification-before-completion) — 完成前验证能力（如可用）
• Skill(attune:mission-orchestrator) — 全生命周期编排能力

相关智能体

• Agent(attune:project-implementer) — 任务执行智能体

相关命令

• /attune:execute — 调用本技能
• /attune:execute --task [ID] — 执行指定任务
• /attune:execute --resume — 从最近检查点恢复执行

任务报告（Mission Report）

任务完成后，需依据 references/mission-report.md 模板生成《任务报告》，内容包括：

• 任务标识：关联需求简报、规格说明、实施计划链接
• 执行周期：起始时间、结束时间、总耗时
• 执行结果：成功 | 部分成功 | 失败
• 交付产物：新增/修改/删除的文件列表
• 关键决策：重要选择及其依据
• 验证证据：测试结果、评审记录、演示视频等
• 后续建议：推荐的下一步行动

详见 references/mission-report.md 中提供的完整模板，以及针对成功、部分成功和失败三类任务的示例报告。

示例

完整示例请参见 /attune:execute 命令文档。