mcpField
W
writing-plans

writing-plans

github.com/hjewkesAgent 工作流443 次安装35 周前更新
代码仓库

关于 writing-plans

writing-plans 是用于编写实施计划的技能，将计划整理为目录，包含统筹计划和面向 Agent 的任务简报。它规定目录结构、文件格式、计划生命周期指引及交接执行的方式。

主要功能

  1. 01计划目录结构
  2. 02统筹计划与任务简报
  3. 03机器可读的任务清单
  4. 04计划格式与生命周期指南
  5. 05执行交接选项

适用场景

  1. 01为 Agent 准备实施工作
  2. 02将工作拆分为任务简报
  3. 03将已完成计划交接执行

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hjewkes/agent-skills --skill writing-plans

安装后在 Claude Code 中输入/writing-plans确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
briefing-template.md
formats.md
plan-lifecycle.md
scripts/
verify-criteria

详细介绍

编写计划

概述

将实现计划编写为计划目录——一份精简的编排计划，以及按任务划分、供 Agent 使用的简报文件。假设 Agent 对代码库一无所知。记录他们所需的一切：要修改哪些文件、完整代码、测试和验证标准。遵循 DRY、YAGNI 和 TDD。频繁提交。

开始时请说明：“我将使用 writing-plans 技能创建实现计划。”

**上下文：**可单独调用，也可作为头脑风暴后的交接。可在当前目录或专用 worktree 中使用。

将计划保存到：.claude/plans/YYYY-MM-DD-<feature-name>/

目录生命周期（创建、执行、清理、过期检测）请参阅 references/plan-lifecycle.md。

计划目录结构

.claude/plans/YYYY-MM-DD-<feature-name>/
  plan.md              # Orchestration plan (<200 lines)
  manifest.json        # Machine-readable task/wave metadata
  briefings/
    task-01.md         # Per-task agent briefing
    task-02.md
    ...

格式规范

有关 plan.md 模板、manifest.json 架构和简报编写规则，请参阅 references/formats.md。

简报文件模板：references/briefing-template.md。

执行交接

保存计划目录后，提供执行选项：

“计划已完成并保存到 .claude/plans/<plan-id>/。你想如何执行？”

选项：

  1. 立即执行 — 我会按任务分派 Agent，并在每项任务之间进行审查（继续在本次会话中）
  2. 在单独的会话中执行 — 开启新会话并调用 plan-execution，批量执行计划

**必需的子技能：**无论选择哪种方式，都必须使用 plan-execution。

评论

支持 Markdown