SuperAPI AI 工具集

create-walkthrough

智能体与模型

查看项目

更新于 10-16 06:49

技能介绍

用途:在 PR 交付阶段生成 .agent/{branch-name}/walkthrough.md,作为已完成工作的最终总结,供参考与交接。

前提条件:所有测试通过;文档已更新;plan.md 已存在且 Progress Log 为最新;需位于 worktree 内。

主要能力与流程:

  1. 确定文件位置并收集信息。用命令获取分支名与 git 信息,不猜测分支名: BRANCH=$(git branch --show-current) && mkdir -p ".agent/${BRANCH}" && echo "Artifact path: .agent/${BRANCH}/walkthrough.md" && echo "---" && git diff --stat main...HEAD && echo "---" && git log --oneline main...HEAD 读取 plan.md: BRANCH=$(git branch --show-current) && cat ".agent/${BRANCH}/plan.md" 从中提取 Summary、Decisions、Requirements、File Changes 表;并从测试结果确认当前状态。
  2. 按模板写入 walkthrough.md,不硬编码或猜测分支名。模板含 frontmatter(created、branch、task、pr)及 Summary、Changes 表、Key Decisions、Testing Results、How to Verify、Next Steps 等章节;时间戳须用完整 ISO 8601(YYYY-MM-DDTHH:MM:SSZ)。
  3. 写完后在对话中直接输出内容,让用户立即看到。

交付方式:文件保存到 .agent/{branch-name}/walkthrough.md,同时在对话中内联展示并附 PR 链接,两者均为必需。

验证清单:文件位置正确、frontmatter 完整、时间戳含时间、Summary 简洁、Changes 表与 git diff --stat 一致、Key Decisions 来自 plan.md、Testing Results 反映实际结果、How to Verify 可操作、已向用户展示。

限制:资料未提供该技能的收费、价格、平台支持范围及具体安装方式等信息。