name	execute-implement
description	对照 Issue 与验收标准开发。Use when 一个 Issue 被分配、准备写代码/写测试/修 Bug 时。也适用于需要按验收标准实现功能、并保证产出包含测试与示例、提交前自查的场景。

Execute-Implement：开发执行

概述

对照 Issue 和 P0-P3 验收标准写代码，产出必须包含单元测试、功能测试、使用示例，提交前先自查。

核心原则： 一次只做一个 Issue，一次做对，不靠反复重试（重试是最大的 token 浪费源）。

何时使用

某个 Issue 被分配，进入开发
修 Bug（先写复现测试，再修）

何时不用： 需求/拆分还没定（先 plan-spec / plan-breakdown）；纯调研（用 explore 子 Agent，不写代码）。

流程

读 Issue 与验收标准 — 明确 P0/P1 必须满足项、输入/输出、依赖。
先出测试计划 — 编码前列出测试场景 + 预期结果，交用户确认（见 verify-test）。
按 TDD 实现 — 先写失败测试，再写最小实现使其通过，再重构。参考 reference/vendored-skills/superpowers/skills/test-driven-development。
补功能测试 + 使用示例 — 至少 1 正常 + 1 异常；2-3 个实际用法示例。
提交前自查 — 用 verify-review 对照验收标准逐项自审，再提交 PR/合入。
写 PR Summary — 用 templates/pr-summary-template.md。

Token 与信息获取

Issue 足够小，一次做对。
信息按需获取 — 通过 CONTEXT_INDEX.md 按路径读取所需文档，不一次性灌入全部上下文。
同一段代码反复写不对（≥2 次）→ 委托 explore 子 Agent 查文档/查类似实现，不要硬撞。

并行注意

并行处理的 Issue 必须操作不同文件/模块，否则串行，避免冲突。共享 DB Schema、接口契约、代码风格。

产出

代码 + 单元测试 + 功能测试 + 使用示例
PR（附 PR Summary）

约束（不可回调）

P0 无法满足时停止上报，不自行降低标准。
不超出 Issue 范围（YAGNI）。
中文注释用 UTF-8，避免乱码。

常见错误

不写测试就提交 → 违反三层测试要求，必被 review 退回。
越界实现 → 顺手改了别的功能，破坏其他 Issue。严守边界。
撞墙硬写 → 同一问题反复失败仍不调研，浪费 token。2 次失败即委托 explore。

参考

模板：templates/pr-summary-template.md
配套：skills/verify-test/SKILL.md、skills/verify-review/SKILL.md
借鉴：reference/vendored-skills/superpowers/skills/test-driven-development、subagent-driven-development
方法论出处：唯一真源 docs/AI 编程方法论 v1.2 — 可操作版.md 第 2.1 / 2.3 / 2.6 / 3.3 节

Más de este repositorio

mismo repositorio

feature

SWUSTcyt/langchain-travel-agent

Use when 需要在当前项目中实现新功能、优化现有代码或修复 bug。触发场景：用户提出功能需求、代码需要重构、发现 bug 需要修复、需要对齐架构文档规范进行开发。

2026-06-2640

improve-retro

SWUSTcyt/langchain-travel-agent

问题记录与定期总结提炼。Use when 同一问题反复出现、Milestone 结束、或需要把踩过的坑提炼成可复用规则/新 Skill 时。也适用于定期复盘、更新验收标准或拆分策略、沉淀方法论的场景。

2026-06-2640

observe-session

SWUSTcyt/langchain-travel-agent

可观测性与模型降质检测。Use when 一次开发会话结束、需要记录 Session 摘要、或怀疑模型出现降质（反复返工、标准滑坡、摸鱼）时。也适用于需要追踪 Issue 状态、生成 PR 摘要、复盘 token 花费的场景。

2026-06-2640

plan-breakdown

SWUSTcyt/langchain-travel-agent

任务归约拆分与验收标准前置。Use when 已有 Spec 或较清晰的需求、要把大需求切成可执行任务、准备启动开发之前。也适用于需求太大、一个 Agent 无法独立完成、需要拆成 Epic/Milestone/Issue 并定义 P0-P3 验收标准的场景。

2026-06-2640

plan-spec

SWUSTcyt/langchain-travel-agent

需求规格评审。Use when 启动新项目/新功能、需求还模糊、在任务拆分或写代码之前，需要先和用户对齐需求边界并产出结构化 Spec 时。也适用于用户给的需求一句话太笼统、缺少边界与非功能性要求的场景。

2026-06-2640

understand

SWUSTcyt/langchain-travel-agent

Use when 进入一个新项目或项目结构发生重大变化，需要生成/更新架构文档（docs/ARCHITECTURE.md）。触发场景：首次接入项目、重构后文档过时、新成员需要上下文、agent 需要理解项目全貌。

2026-06-2640

name	execute-implement
description	对照 Issue 与验收标准开发。Use when 一个 Issue 被分配、准备写代码/写测试/修 Bug 时。也适用于需要按验收标准实现功能、并保证产出包含测试与示例、提交前自查的场景。

Execute-Implement：开发执行

概述

对照 Issue 和 P0-P3 验收标准写代码，产出必须包含单元测试、功能测试、使用示例，提交前先自查。

核心原则： 一次只做一个 Issue，一次做对，不靠反复重试（重试是最大的 token 浪费源）。

何时使用

某个 Issue 被分配，进入开发
修 Bug（先写复现测试，再修）

何时不用： 需求/拆分还没定（先 plan-spec / plan-breakdown）；纯调研（用 explore 子 Agent，不写代码）。

流程

读 Issue 与验收标准 — 明确 P0/P1 必须满足项、输入/输出、依赖。
先出测试计划 — 编码前列出测试场景 + 预期结果，交用户确认（见 verify-test）。
按 TDD 实现 — 先写失败测试，再写最小实现使其通过，再重构。参考 reference/vendored-skills/superpowers/skills/test-driven-development。
补功能测试 + 使用示例 — 至少 1 正常 + 1 异常；2-3 个实际用法示例。
提交前自查 — 用 verify-review 对照验收标准逐项自审，再提交 PR/合入。
写 PR Summary — 用 templates/pr-summary-template.md。

Token 与信息获取

Issue 足够小，一次做对。
信息按需获取 — 通过 CONTEXT_INDEX.md 按路径读取所需文档，不一次性灌入全部上下文。
同一段代码反复写不对（≥2 次）→ 委托 explore 子 Agent 查文档/查类似实现，不要硬撞。

并行注意

并行处理的 Issue 必须操作不同文件/模块，否则串行，避免冲突。共享 DB Schema、接口契约、代码风格。

产出

代码 + 单元测试 + 功能测试 + 使用示例
PR（附 PR Summary）

约束（不可回调）

P0 无法满足时停止上报，不自行降低标准。
不超出 Issue 范围（YAGNI）。
中文注释用 UTF-8，避免乱码。

常见错误

不写测试就提交 → 违反三层测试要求，必被 review 退回。
越界实现 → 顺手改了别的功能，破坏其他 Issue。严守边界。
撞墙硬写 → 同一问题反复失败仍不调研，浪费 token。2 次失败即委托 explore。

参考

模板：templates/pr-summary-template.md
配套：skills/verify-test/SKILL.md、skills/verify-review/SKILL.md
借鉴：reference/vendored-skills/superpowers/skills/test-driven-development、subagent-driven-development
方法论出处：唯一真源 docs/AI 编程方法论 v1.2 — 可操作版.md 第 2.1 / 2.3 / 2.6 / 3.3 节