mcpField
C
codely-plan-create-subagents

codely-plan-create-subagents

github.com/codelytvAgent 工作流296225 次安装1 天前更新
代码仓库

关于 codely-plan-create-subagents

用于创建实现计划的技能，要求将代码库调研委派给子 Agent。它会先确认阶段和公共契约，再保存带日期的计划文件，并提供后续选项，不会自动开始实现。

主要功能

  1. 01起草前要求阅读计划指南
  2. 02将代码库调研委派给子 Agent
  3. 03定义阶段和公共契约
  4. 04写入计划文件前征求批准
  5. 05将计划保存到带日期的目录
  6. 06提供受控的后续操作选项

适用场景

  1. 01规划涉及多个代码区域的变更
  2. 02协调对独立组件的并行调研
  3. 03编码前确认实现阶段和契约

安装

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

$npx skills add https://github.com/codelytv/agent-harness --skill codely-plan-create-subagents

安装后在 Claude Code 中输入/codely-plan-create-subagents确认已加载。

附带文件resources/plan-guidelines.md

详细介绍

🧠 如何创建计划

计划的结构、各个部分以及编写规则均定义在 resources/plan-guidelines.md 中。请先阅读，再提出任何内容。

  1. 如果用户尚未说明要为哪个任务制定计划，请询问用户。

  2. 按照🔍 使用子 Agent 探索代码库中的说明，使用子 Agent 探索代码库。不要自行探索代码库：请委派这项工作。

  3. 定义任务阶段，并按照指南所述，让用户选择阶段数量。

  4. 按照指南所述，明确每个阶段任务中要创建、修改或删除的公共契约。

  5. 向用户提出计划以供批准。重要：在用户同意具体要考虑的契约和实施阶段之前，不要开始创建计划文件。

  6. 将计划保存为 .agents/plans 子文件夹中的新文件，使用当前日期和基于任务描述的语义名称。结构如下：.agents/plans/{plan-name}/{plan-name}-plan.md。示例：2026_01_16-create_embeddable_changelog_widget/2026_01_16-create_embeddable_changelog_widget-plan.md。

  7. 建议后续步骤

    • 创建计划文件后，询问用户想要做什么：
      • 不执行其他操作。
      • 通过运行 /codely-git-conventional-commit 技能，将计划文件提交到代码库。若仅修改计划文件，请使用 docs 类型。
      • 通过运行 /codely-plan-phase-implement @plan-file-path 技能实施计划。
      • 提交计划文件，然后仅实施第 1 阶段。

    重要

    如果用户要求“提交并实施”，请先提交计划文件，然后仅实施第 1 阶段。切勿一次性实施所有阶段。/codely-plan-phase-implement 技能每次调用只处理一个阶段。

🔍 使用子 Agent 探索代码库

通过委派子 Agent 探索，而不是自行阅读代码库，收集制定计划所需的上下文（相关文件、现有惯例、当前行为、受影响的契约）。主 Agent 应专注于推理和编写计划。

  • 如果已有用于探索的子 Agent，请重复使用。
  • 为子 Agent 选择成本更低的模型。如果工具支持覆盖模型，请选择同系列中更轻量、速度更快的模型。例如，在使用 Opus、Fable 或 Sonnet 的会话中，可使用 Haiku 启动探索子 Agent。
  • 根据任务决定启动多少个子 Agent。范围小且位置明确的改动可能只需一个；涉及多个独立上下文、层或界面的任务，则每个独立研究领域安排一个。最多 4 个。
  • 一次性并行启动相互独立的子 Agent，避免探索过程变成串行。
  • 为每个子 Agent 分配范围明确、可独立完成的任务。例如，分别探索架构、前端、后端、不同功能或不同代码库……
  • 请它们汇报具体文件路径、相关现有契约以及需要遵循的惯例，而不是倾倒整个文件内容。
  • 在提出计划前，先自行综合子 Agent 的报告。只有在仍需确认契约或惯例时，才直接阅读相应的具体文件。

🗃️ Frontmatter

计划文件应包含以下 frontmatter：

---
name: "{ plan_name }"
description: "{ plan_description }"
created_at: "{ current_date }"

created_by:
  tool: "{ tool }"
  model:
    name: "{ model.name }"
    version: "{ model.version }"
    reasoning_effort: "{ model.reasoning_effort }"
---
  • current_date：当前日期，格式为 ISO 8601 RFC 3339（YYYY-MM-DDTHH:MM:SSZ）。
  • created_by.tool：所使用的 AI 编码工具（例如 Claude Code、Cursor、Copilot、Codex）
  • created_by.model.name：用于进行此次更改的模型名称（例如 Claude Opus、Cursor Composer、OpenAI GPT）
  • created_by.model.version：模型版本（例如 4.6、1.5、5.4）
  • created_by.model.reasoning_effort：模型的推理强度（例如 low、medium、high）

评论

支持 Markdown