Skip to Content
其他Skills 教程用好 Matt Pocock Skills案例 · 周报打磨:批量任务的 context 黑洞

案例 · 周报打磨:批量任务的 context 黑洞

原提示词:gt-main-site-web-app/.ai/prompt/2026/0724/0909/plan-01.md —— 周报打磨。

上一篇:案例 · 测试手册 · 下一篇:常见困境

这份提示词在做什么

  • 输入:9 期周报目录(06-01 ~ 07-27)+ 三仓库 git 提交(services / web-app / install-app,简写见 CONTEXT.md)。
  • 约定:写法约定在项目根 CONTEXT.md,格式范本在 app/03-work/01-weekly-report/2026/08-03/page.mdx。约定或范本改进时提示词无需改,只改「目标」日期。← 已把格式解耦。
  • 人机边界:「其它工作」(逐日杂项、协作沟通、线上排障)由人工维护,AI 不自动生成。← 已划人机边界。
  • 产物:9 期打磨后的 page.mdx

它比案例 · 测试手册成熟:已经把格式解耦、也划了人机边界。剩下的短板全在执行

诊断:执行上的两个坑

  1. 9 周 × 3 仓库的提交是 context 黑洞 —— 提示词把”三仓库逐周映射”当素材,一次性全读进主 context,9 周提交会撑爆 smart zone。
  2. 批量 9 期一口气磨完会糊 —— 9 期周报不该在一个 context 里连磨,该按期切 phase。

改造:拆成 skills flow

三步:① 后台收集三仓库提交 → ② 逐期 /grill-with-docs 打磨 → ③ 人工补「其它工作」。下面每步都是能直接跑的指令 + 提示词,可复制。

第 1 步 · 后台收集三仓库的逐周提交

三个仓库各发一个 /research(后台并行,不占主 context)。提示词结构相同,只换仓库路径和输出文件名:

# 〔services〕仓库 —— 逐周提交汇总 /research 汇总仓库 /mnt/wsl/gt-1/var/lib/workspace/es/es-center-server-services 自 2026-06-01 到 2026-07-27 的全部 git 提交,按这 9 周分组:06-01/06-08/06-15/06-22/06-29/07-06/07-13/07-20/07-27。每周列出每条提交:commit hash、摘要、改动意图(从 commit message 推断)。每条标注为〔设计/决策〕或〔代码实现〕。结果写到 .ai/doc/weekly/source-services.md,带 hash 引用。
# 〔web-app〕仓库 —— 同上,换路径与输出名 /research 汇总仓库 /mnt/wsl/gt-1/var/lib/workspace/es/es-center-server-web-app 自 2026-06-01 到 2026-07-27 的全部 git 提交,按上述 9 周分组,每条给 hash、摘要、改动意图,标注〔设计/决策〕或〔代码实现〕。结果写到 .ai/doc/weekly/source-web-app.md。
# 〔install-app〕仓库 —— 同上,换路径与输出名 /research 汇总仓库 /mnt/wsl/gt-1/var/lib/workspace/es/es-center-server-install-app 自 2026-06-01 到 2026-07-27 的全部 git 提交,按上述 9 周分组,每条给 hash、摘要、改动意图,标注〔设计/决策〕或〔代码实现〕。结果写到 .ai/doc/weekly/source-install-app.md。

跑完,三份 md 就是后续打磨的 primary source(在文件里,不在主 context 里)。

第 2 步 · 逐期打磨(每期一次 /grill-with-docs

约定(CONTEXT.md 的项目简写 / 活动标签 / 术语)和结构(08-03 范本)都在文件里,跨期复用。从最早一期开始,每期一次,提示词只换日期和路径:

# 打磨 06-01 这期周报 /grill-with-docs 打磨 app/03-work/01-weekly-report/2026/06-01/page.mdx 这期周报。 素材:.ai/doc/weekly/source-services.md、source-web-app.md、source-install-app.md 中属于 06-01 这周的三仓库提交。 依据:项目根 CONTEXT.md 的项目简写 / 活动标签 / 术语;结构对齐 app/03-work/01-weekly-report/2026/08-03/page.mdx 范本。 要求:工作量按「设计 vs 代码」拆分计量;重度拆条,用 8 个活动标签归类;「其它工作」区域留空,由我手填,你不要生成。

磨完一期 → 提交 → /clear(接近 smart zone 就 /compact)→ 接下一期。CONTEXT.md 有要改进的地方,顺手用 /domain-modeling 更新(它是跨期复用的活约定)。

为什么用 /grill-with-docs 而非 /grill-me —— 周报在 repo 内、且要维护 CONTEXT.md 这份约定(改进时更新)。grill-with-docs 正是”在 working directory 里 + 留痕维护约定”的那个。(对照案例 · 测试手册的一次性产出,用 grill-me。)

第 3 步 · 人工补「其它工作」

每期 page.mdx 里留空的「其它工作」(逐日杂项、协作沟通、线上排障)由你自己填——这是 AI 不生成、也不该生成的部分。

为什么这样拆

步骤skill补的短板
三仓库逐周提交收集/research(后台并行)9 周 × 3 仓库提交是 context 黑洞;分仓丢后台
维护约定/术语/标签/domain-modeling(grill 内)CONTEXT.md 是活约定,改进时更新
逐期打磨成周报/grill-with-docs按约定 + 范本磨成双用途叙述;维护 CONTEXT.md
批量 9 期节奏phase boundary每期一个 phase,边界 /compact;约定在文件里跨期复用

收益

  • Context 健康:9 周提交分仓丢后台,主 context 每次只磨一期。
  • 解耦被强化:提示词”格式在 CONTEXT.md + 范本”的设计被 skills 做实 —— CONTEXT.md 成为真正跨期复用的活 primary source。
  • 人机分工落地:“设计·代码拆分计量”是这条 flow 的内建属性(设计计给你、代码计给 AI);“其它工作”显式留给人工。

验收(可复用的成功标准)

  • 每期符合 CONTEXT.md 约定(项目简写、活动标签、术语)。
  • 每期结构与 08-03 范本一致。
  • 工作量按「设计 vs 代码」正确拆分计量(呼应人机分工)。
  • 重度拆条 + 8 活动标签覆盖到位。
  • 回修项深查看:列步骤名 + diff 证据。
  • 「其它工作」区域留空待人工补,AI 不越界生成。

上一篇:案例 · 测试手册 · 下一篇:常见困境 →