agentleFS
MarecGentsMarecGents/marec-agent-skills/skills/default/SKILL.md

default

Skill3 starsChanged 3 months agoMITView on GitHub

通用默认工作流技能。当用户提出一个任务但没有匹配到更具体的专项技能时,使用此技能作为兜底方案。

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. NVIDIA/NeMo-Fabric★ 73same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository8 other files it gives its agents.

The file

Files
SKILL.md

Default — 通用默认工作流

当你收到一个用户任务,且没有更具体的专项技能匹配时,按照本技能定义的三阶段工作流执行。


核心原则

  1. 必须先调用 brainstorming — 每次任务执行必须先调用 brainstorming 技能进行前期构思和分析,不得跳过此步骤。这帮助你在动手之前全面理解用户意图、项目目标和潜在挑战。
  2. 必须用 planning-with-files 做追踪 — 调用 planning-with-files-zh 技能进行任务文件化追踪,该技能会创建 task_plan.md、findings.md、progress.md 三个核心追踪文件,让整个过程有迹可循、可回溯。
  3. 任务结束后清理并归档 — 基于三个规划文件生成最终的任务日志文档,存入 ./docs/,然后删除过程中产生的无用文件。
  4. 规范统一由 skill-standard-harness 管理 — 操作层面的公共规范(如 GitHub 仓库访问规范、Markdown 输出规范等)由 skill-standard-harness 统一维护,本技能不再重复定义。
  5. 规划阶段必须做技能匹配 — 在任务拆解与规划时,检索可用技能(本仓库及其他已安装技能),为每个子任务匹配最合适的技能,并在最终计划中显式列出「使用某某技能执行某某任务」。避免有现成技能不用、重复造轮子。
  6. 互不相关的子任务必须并行执行 — 若任务包含多个互不相关(无数据/顺序依赖)的子任务,必须开启并行子代理执行而非串行,以最大化效率;有依赖关系的部分保持串行。
  7. 遵守认知纪律 — 执行前先审前提,独立判断不迎合,来源可追溯,有错直说,主动提示盲区;详见「认知纪律与诚实准则」章节。

认知纪律与诚实准则

以下准则适用于本技能三阶段工作流的所有阶段,与工作流规则同等优先。

冲突处理:当本准则与用户即时指令冲突时,默认执行准则;若用户明确要求覆盖,照办,但必须先说明风险。

  1. 先审前提 — 执行前先检查问题本身:是否存在错误前提、逻辑跳跃或信息缺失?发现可疑之处先澄清,不带着未经验证的假设开工。
  2. 独立判断,不一味迎合 — 对用户观点和自身输出都做独立判断,不因顺从而附和。所有信息区分「事实 / 预测 / 主观观点」:事实要求可核实,预测必须标注不确定性,主观观点必须明示立场。
  3. 来源可追溯 — 涉及数字、任务和结论时,尽可能核实并标注信息来源:能核实的给出处(已核实);无法核实的明确标注「推断-未验证」,不以确定语气伪装。
  4. 有错直说 — 发现用户说得不对时,直接指出,并说明三件事:依据(为什么不对)、风险(照原样做的后果)、更合适的解释或做法。
  5. 主动提示盲区 — 主动提醒用户可能忽略的变量、成本与偏差,即使未被问到。

GitHub 仓库访问规范

如果任务涉及从 GitHub 获取仓库代码(如复现项目、下载源码、引用示例等),请调用 skill-standard-harness 技能了解完整的访问规范与操作流程。


三阶段工作流

阶段一:Brainstorming(前期构思 + 技能匹配 + 并行策略决策)
  ↓
阶段二:Planning with Files(文件化执行,含技能映射记录与并行子代理调度)
  ↓
阶段三:任务收尾(归档 + 清理)

阶段一:Brainstorming(前期构思 + 技能匹配)

触发条件:接收到用户任务后立即进入此阶段。

执行步骤:

  1. 调用 brainstorming — 对任务进行初步分析构思。思考:
    • 用户到底想要什么?核心诉求是什么?
    • 这个任务涉及哪些方面?
    • 可能遇到哪些主要挑战?
    • 需要哪些前置条件或资源?
  2. 前提审查(必做) — 在进入方案设计之前,先检查任务本身是否存在:
    • 错误前提 — 用户陈述中与事实不符或未经验证的假设;
    • 逻辑跳跃 — 从诉求到方案之间缺失的推理环节;
    • 信息缺失 — 影响方案成立的关键事实、约束或边界条件。 发现上述问题:按「认知纪律与诚实准则」第 1、4 条向用户澄清或指出,不得带着未验证的假设进入后续步骤。
  3. 遵循 brainstorming 流程:
    • 探索项目上下文(文件、文档、最近的变更)
    • 逐一提出澄清性问题,理解目的、约束和成功标准
    • 提出 2-3 种方案,附上权衡分析和你的推荐
    • 分部分呈现设计,每部分获得用户确认后再继续
    • 将确认后的设计写入设计文档(按 brainstorming 默认路径)
    • 让用户审查书面规格
    • 重要:在用户批准设计之前,不得开始任何实现工作
  4. 技能匹配(必做) — 在设计中识别各子任务所需能力,检索可用技能列表(本仓库及全局已安装技能),为每个子任务匹配最合适的技能。技能匹配规则:
    • 优先级从高到低:① 专用专项技能(如复现项目用 github-project-replication、处理 docx 用 docx、下载抖音用 douyin-downloader)→ ② 通用工作流技能(本 default)→ ③ 不匹配任何技能时直接执行
    • 匹配依据技能的 description 与任务意图的契合度,不凭名字猜
    • 将匹配结果暂存于设计文档(brainstorming 的设计文档),阶段二初始化 task_plan.md 后正式写入,格式:- [子任务] → 技能:<skill-name>(原因:...)
  5. 执行策略决策(并行 or 串行) — 对设计中的子任务做依赖分析:
    • 无依赖(互不相关):标记为可并行
    • 有依赖(顺序/数据依赖):标记为串行,明确依赖链
    • 将决策暂存于设计文档,阶段二初始化 task_plan.md 后正式记录(见阶段二)
  6. 设计获得批准后,进入阶段二。

阶段二:Planning with Files(文件化执行)

执行步骤:

  1. 调用 planning-with-files-zh — 初始化三个追踪文件:
    • task_plan.md — 将任务拆解为可执行的阶段和清单
    • findings.md — 预留研究笔记空间
    • progress.md — 准备记录操作日志
  2. 规划文件中显式记录技能映射与并行策略 — 在 task_plan.md 中为每个子任务标注:
    ## 任务拆解与技能映射
    - 子任务 A(无依赖 → 并行)→ 技能:xxx(原因:...)
    - 子任务 B(无依赖 → 并行)→ 技能:yyy(原因:...)
    - 子任务 C(依赖 A 的输出 → 串行,在 A 之后)→ 技能:zzz(原因:...)
  3. 遵循 planning-with-files-zh 的工作模式:
    • 每一步操作前重新读取计划文件,保持目标清晰
    • 每执行 2 次查看/搜索操作后,将关键发现写入文件
    • findings.md 中的信息按「事实 / 预测 / 主观观点」分级记录
    • 涉及数字、任务和结论时标注来源(已核实 / 推断-未验证)
    • 所有错误都要记录到文件中,防止重复失败
    • 每个阶段完成后更新 task_plan.md 状态
    • 遵循「三次失败协议」:3 次尝试失败后向用户求助
  4. 按计划执行任务,并行子任务用子代理并行执行:
    • 判定并行:子任务之间无数据依赖、无顺序依赖、可独立完成 → 并行
    • 并行执行方式:为每个可并行子任务启动一个独立子代理(如 task / fleet / parallel_tasks),在最终计划中写明每个子代理的输入、输出路径与验收标准;各子代理返回结果后由主进程统一汇总、交叉验证
    • 串行部分:有依赖关系的子任务按依赖链顺序执行,前序输出作为后序输入
    • 并行规模:并行子代理数量建议 2-4 个,避免上下文过载;共享文件写入冲突时给每个子代理分配互不重叠的写路径
    • 实时更新进度:根据 task_plan.md 的阶段划分,逐一完成,实时更新进度和发现

阶段三:任务收尾(归档 + 清理)

执行步骤:

  1. 生成任务日志文档:
    • 基于 task_plan.md、findings.md、progress.md 三份文件
    • 整合生成一份完整的日志文档
    • 命名规则:根据任务内容总结一个概括性名称,加上年月日时分
    • 格式:{概括性名称}-{YYYY-MM-DD-HHmm}.md
    • 例如:用户登录模块重构-2026-06-27-1530.md
    • 保存路径:./docs/(如果 ./docs/ 目录不存在,自动创建)
    • 内容应包含:
      • 任务概述(名称、目标、范围)
      • 执行过程摘要(每个阶段做了什么)
      • 关键发现与决策
      • 遇到的问题与解决方案
      • 最终结果与状态
  2. 清理无用文件:
    • 删除 .planning/ 目录(如果存在)
    • 删除项目根目录下的 task_plan.md(如果存在)
    • 删除项目根目录下的 findings.md(如果存在 — 注意:如果用户原本就有自己的 findings.md,只删除由 planning-with-files 创建的内容,或与用户确认)
    • 删除项目根目录下的 progress.md(如果存在)
    • 注意:不要删除用户原有的重要文件。如果发现 findings.md 在技能运行前就已存在,询问用户是否删除。
  3. 输出最终结果摘要 — 用简洁的语言告诉用户:
    • 任务是否完成
    • 主要产出物(文件列表、路径)
    • 任务日志位置
    • 遗留问题(如果有)

错误处理与异常

异常场景处理方式
用户未批准设计如果 brainstorming 阶段用户对设计不满意,回到设计环节修改,直到用户批准
任务中途变更需求更新 task_plan.md 和 findings.md,记录变更,调整剩余计划(含技能映射与并行策略)
三次连续失败停止当前操作,向用户说明尝试过的方法和具体错误,请求指导
清理时发现用户原有文件不自动删除,询问用户确认
并行子代理执行失败标记失败子任务,不阻塞其他并行子代理;全部结束后由主进程汇总失败原因并重试失败项
并行子代理写文件冲突规划时为各子代理分配互不重叠的写路径(见阶段二第 4 步);冲突发生时合并冲突内容并记录到 findings.md
子任务之间出现隐藏依赖停止该子代理,改为串行执行;将依赖关系补录到 task_plan.md,避免结果不一致
发现用户前提或指令有误不迁就执行:按「认知纪律与诚实准则」第 4 条直接指出错误,说明依据、风险与更合适的解释;待用户澄清或确认后再继续(默认纪律优先,用户明确覆盖时照办但先说明风险)

输出规范

请调用 skill-standard-harness 技能并读取 references/markdown-output-standard.md,按照统一的 Markdown 输出规范执行(标题层级、时间戳格式、日志文档结构、文件命名规则等)。

本技能特有要求:progress.md 每条记录必须包含时间戳(格式:YYYY-MM-DD HH:mm)。


成功标准

任务完成时,以下条件应全部满足:

  • Brainstorming 已完成,设计已获用户批准
  • 前提审查已完成(错误前提 / 逻辑跳跃 / 信息缺失均已被检查或澄清)
  • 发现的问题均已指出或确认无(错误前提、来源可疑、用户盲区)
  • 规划阶段已完成技能匹配,task_plan.md 中显式列出了「子任务 → 技能」映射
  • 已对子任务做依赖分析:互不相关的子任务通过并行子代理执行,有依赖的按依赖链串行执行
  • Planning with Files 的三个追踪文件已创建并全程使用
  • 任务目标已达成
  • 完整的任务日志文档已生成到 ./docs/
  • 无用文件已清理

使用示例

示例 1:数据处理任务

用户:帮我整理一下这个 CSV 文件,把销售额按月份汇总

触发此技能后:

  1. 调用 brainstorming:理解数据结构、汇总需求、输出格式
  2. 技能匹配:无更合适的专项技能 → 使用本 default 工作流;规划中记录「数据汇总 → 直接执行(无技能匹配)」
  3. 用户确认设计后,创建 task_plan.md 等文件开始执行
  4. 完成数据汇总,生成日志 销售额月度汇总-2026-06-27-1530.md 到 ./docs/
  5. 清理 .planning/ 和追踪文件

示例 2:小型功能开发

用户:给我的网站加一个回到顶部按钮

触发此技能后:

  1. 调用 brainstorming:探讨按钮样式、位置、滚动行为、兼容性
  2. 技能匹配:前端 UI 任务 → 可考虑 frontend-design 技能(若已安装)辅助视觉设计,规划中显式列出
  3. 用户确认后创建规划文件并实现
  4. 生成日志 回到顶部按钮-2026-06-27-1600.md 到 ./docs/
  5. 清理临时文件

示例 3:多子任务并行执行

用户:帮我做三件事——① 整理本周销售数据成 Excel 报告;② 下载这个抖音视频;③ 检查 Reasonix 是否有更新

触发此技能后:

  1. 调用 brainstorming:三件事互不相关,无数据/顺序依赖
  2. 技能匹配:① → xlsx 技能(Excel 处理);② → douyin-downloader 技能;③ → check-reasonix-update 技能
  3. 在 task_plan.md 中显式记录技能映射,并标记三个子任务均为可并行
  4. 为三个子任务各启动一个并行子代理(分配互不重叠的输出路径),主进程等待全部完成
  5. 汇总三个子代理结果,生成最终日志到 ./docs/,清理临时文件

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.