agentleFS
nate2022-ainate2022-ai/nate-ai-skills/skills/grill-requirements/SKILL.md

grill-requirements

Skill8 starsChanged 56 days agoMITView on GitHub

澄清需求、研究规划和生成 AI agent 执行任务书。用于"需求榨干""把需求问透""grill me""先研究再规划"、方案压力测试或明确的任务书、brief、goal 提示词请求;用户直接发送"需求榨干"或"把需求问透"即视为显式触发。普通问答、明确的直接执行请求及内部协作不因此启动长访谈;生成文本不代表执行授权。

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. longfangsong/skills★ 2same name
    2. Cartograf666/alex-ter-vibeskills★ 0same 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 repository3 other files it gives its agents.

The file

Files
SKILL.md

需求榨干:研究规划与执行任务书

以更少的必要往返明确真实需求:先研究并校准目标,AI 自行解决事实与可默认事项,只把用户必须决定的问题交给用户。按主题讨论,信息充分即收口,按明确请求交付规划或执行任务书。

双模式路由

先判定模式,再开始研究;不要在流程末尾临时混写两种产物。

默认:研究规划模式

用户要求问透需求、先研究再规划、压力测方案、形成设计或消除实施前歧义时,使用本模式。按主题推进,高影响决策收口后给简短结果摘要和剩余问题;只有用户明确索要完整规划时才展开,候选 Goal 另按明确请求提供。

显式:执行任务书模式

只有用户明确要求为另一个 AI agent 写“执行任务书、brief、目标任务书、goal 提示词”,要求“让 agent 独立执行”,或明确要求拆出多份执行任务时,才使用本模式。先完成同样的研究与高影响决策收口,再输出一份独立任务书;不要把“请直接实施”“帮我修复”之类普通执行请求擅自改写成任务书请求。

任务书按实际授权状态交付;生成文本与承接执行分别按“已有授权的沿用”和“按模式交付与执行”处理。

goal 授权歧义闸

先按当前明确指令判断是否执行。用户已明确“只分析、不执行”或“只生成任务书”时,直接在已有资料与读取授权范围内研究或生成候选文本,不因出现 goal 一词重复追问执行授权;不创建或调用 Goal,不开始实施。

只有用户只说“goal”,且当前会话与命令状态仍无法判断是在索要未授权任务书,还是已经发出授权执行目标时,才只问:“你是要我只生成未授权的候选任务书,还是已经授权我开始执行?”此时先解决授权歧义,不得改问是否写真实数据、允许读取哪个数据源、范围或技术细节;答复前不创建或调用 Goal,不开始实施。

已有授权的沿用

  • 调用本 Skill 默认进入研究讨论阶段;仅下文“先研究再判断”规定的安全最小试验可生成临时文件或脚本。未获用户明确实施授权,不修改正式文件、代码、配置或业务数据,不写入外部系统,不创建正式任务或 Goal。文本中整理决定不等于将其落盘。普通直接执行请求仍按其明确授权处理,不因自动选用本 Skill 变成长访谈。
  • 按当前上下文判断用户是否明确授权具体动作与范围,不依赖固定口令。研究中的方案认可不构成修改文件或采纳长期规则的授权;研究阶段的“继续”仍为研究,实施阶段的“继续”沿用尚有效的同批授权。
  • 同一批次已有明确授权且范围未变时,按已确认目标、白名单和验收要求连续完成修改、验证及结果交付;不因技术子步骤、阶段小结或执行者提出同义确认而再次询问,也不退回候选任务书或重选执行方式。
  • 先核对所需动作是否已被授权覆盖。出现新增授权缺口、范围扩大、明确停车条件或会显著改变结果的问题时,暂停受影响动作并说明具体原因;一次性授权已消耗或结果未知时,不将“继续”视为重试授权。
  • 用户要求分步骤逐次授权时,只沿用当前已批准批次,下一批次仍按用户要求确认。沿用执行授权不等于新增 Goal、正式任务、外部发送或其他范围外动作的授权。

规则冲突:按影响暂停与接续

若发现更晚的相反决定或新的适用规则冲突,先核对优先级、适用范围与影响;能按现行指令判明的直接处理。仍需用户裁决时,暂停受影响动作,说明冲突依据、对目标和验收的影响及建议,继续可明确分离的已授权工作;影响无法可靠分离时暂停本次整体实施。

用户裁决后核对现有授权;裁决已明确覆盖后续动作时直接继续,只有仍有授权缺口或新增范围时才补问。不把单纯解释冲突自动扩大为实施授权。普通测试失败或现场差异先核查事实,不能自动当作规则冲突,也不能掩盖已发现的规则冲突。

遵守 Codex 宿主的规则优先级、工具权限及当前用户指令,不用本 Skill 改写全局或项目规则。路径、真相源和进度机制沿用所属项目规定,超出已有授权的新增或扩大写入仍须补齐授权。

路由冲突

  • 用户同时要求规划和任务书时,先完成规划,再按已确认规划生成任务书;明确标出两者的关系,避免双份事实互相漂移。
  • 主代理可在已授权边界内,按实际收益委派只读调查或独立、可回退的本地修改,不因内部拆分重复询问或切换为任务书模式。同一实际修改范围只由一个执行者写入,主代理负责整合与验证;审查者保持独立,不自行修改被审成果。用户明确只读、禁用或暂缓代理时遵守该限制。
  • 内部分工不扩大原授权,也不自动授权创建正式可见任务、外部业务动作、后台代理、工作流 或 Goal;需要这些能力时分别核对现行授权。

讨论原则

  • 每轮一个决策主题,可合并两三个紧密关联的事项;上游未定时不夹带依赖它的下游决定。
  • 不设默认字数。只展示当前主题的结论、必要事实、推荐及理由、代价与风险;需要判断时等待回应,再进入下一主题。
  • 关键风险和前置条件必须在相关决定前讲清;主题过大时拆小,不先索取确认、后补影响决定的信息。
  • 比较方案时给互斥、真实的选项,允许自定义答案。单一确认自然提问,表达和交互方式服从用户及宿主要求。
  • 允许用户回答“不知道”或“以后定”,区分实施前必须解决、某阶段再解决和可安全默认的事项。
  • 按实际后果、逻辑耦合和返工成本判断影响;直接指出冲突、隐含假设、过度设计和低回报需求。

按需读取

普通需求讨论只读本文件。出现下列条件时,由本入口选择当前必需的材料;只因后面可能用到,不预加载。已读且未变、上下文仍充分时复用;缺失或变化时定向补读。关联文件引用已有规则不表示要重新读取,也不沿引用递归加载。

当前需要读取材料
用户明确索要完整规划或候选 Goal 文本规划模板,仅使用被请求部分
用户明确索要执行任务书,或已授权正式任务需要补齐交接任务书模板,识别请求时即读取生成条件,关键条件收口后生成
准备创建、跟进或验收独立正式任务,或用户询问另开任务的执行方式正式任务交接与终验
预计跨多轮、多阶段或跨上下文:生成规划或任务书、进入执行、恢复或核验整体完成长任务接续
需要协调独立分工、已有多任务依赖,或用户明确要求主分任务规划主分任务协作

条件可同时成立,按实际需要组合。短任务在当前对话直接执行,不因此加载正式任务交接模块。模板只在生成对应产物时展开;案例和 tests/ 用于维护、验证或排查 Skill,普通调用不读取。

共用工作流程

1. 定义访谈对象

先利用当前上下文确定:

  • 要解决的真实问题;
  • 预期最终产物;
  • 已知边界与当前不执行的范围;
  • 已发现的最大不确定点。

如果连访谈对象都无法确定,先继续研究;仍无法查明且不同答案会显著改变目标或范围时,才把第一题用于确定对象。否则直接进入决策树过滤。

只有理解发生实质变化或需要用户确认时,才简述当前理解;不固定开场复述。

2. 先研究再判断

在提问前完成与当前决策有关的最小充分研究:

  • 当前对话、项目入口、现行真相源、推进状态和实际文件;
  • 已知业务、技术、时间、预算、权限、合规和授权约束;
  • 权威来源、成熟方案、同类实现及其适用条件;
  • 最可能造成返工、越权、数据错误、不可逆后果或无法验收的风险;
  • 能闭合真实目标的最小可行范围(MVP)及明确不做事项。

外部事实的时效性或准确性会影响选择时,先查权威来源。研究的目标是缩小需要用户决策的范围,不是堆积材料或延迟收口。

已有可靠默认时直接采用,不为走流程试验。对会影响判断、调查仍不能确认的事实性未知,若低成本实际试验能回答,则默认做安全最小试验:在本地隔离环境用临时目录或数据副本,复用现有工具;不改正式文件、配置或业务数据,不外传数据、不写外部系统、不新增付费或不可逆动作。明确“只读/不试验”时不做;越过此边界须先补齐授权。每次只验证关键未知,得到足够结论或继续试验已无明确收益时停止,将结论、适用范围与未验证项合入已有任务理解,不另设阶段或记录流程。

将获得的信息分为:

  • 已确认事实:可由当前证据直接支持;
  • 待验证项:有根据但未足以确认,可在规划或停车闸中验证;
  • 用户决策:没有唯一事实答案,必须由用户取舍。
  • AI 默认:已有成熟、安全、可逆、低成本方案,可直接采用并披露。

不要把事实、AI 默认或可延后验证的事项伪装成用户决策;默认也不能补造事实或代替未明确的高影响价值取舍。

3. 目标校准与双向钢人闸

每次调用都必须执行目标校准检查。先基于已确认事实和明确标注的推断,依次形成:

  1. 对用户真正要解决的问题、期望结果和成功含义的最有力重述;
  2. 当前方向成立的最强理由、适用条件和潜在收益;
  3. 最强反方或替代路径,包括不做、缩小范围、改流程或改用成熟方案;
  4. 双方真正的分歧,以及最可能改变目标、路径、范围、优先级、成本、风险或验收标准的关键变量。

执行时遵守:

  • 不把 AI 推测的隐藏动机写成事实;明确区分已确认事实、推断、假设和用户价值选择。
  • 问题没有天然正反双方时,比较“当前路径”和“最强可行替代路径”;不得为了凑正反双方制造虚假争议,也不得预设反方必然正确。
  • 目标、问题定义和当前方向已经清楚,且不存在会使方案改道的高影响不确定时,把校准后的真实目标和关键变量记入决策账本,不单独展示目标校准卡,不要求用户重复确认,直接继续建立决策树。
  • 只有目标、问题定义或当前方向存在高影响不确定,且满足“建立并过滤决策树”的提问准入条件时,才展示简短的“目标校准卡 · 双向钢人”并暂停。合并表达真实目标、当前方向与最强可行替代、关键分歧、推荐及理由,不叠加重复摘要或强制逐字段填卡:
目标校准卡 · 双向钢人
真实目标:[要得到的结果]
取舍:[当前方向与最强反方或替代路径的必要比较]
推荐:[方向、理由、影响当前决定的风险或前提]
待决定:[最上游且无法安全默认的关键变量]

卡片内容可自然合并;只问一个最上游、最可能改变目标或方向的问题,按需给真实选项。用户回答前不得进入功能、流程、界面、技术实现或执行任务书细节。收到回答后,先更新真实目标、成功标准和决策账本,再继续后续流程。

goal 授权歧义闸始终优先于本节;不得借目标校准绕过授权判断或开始实施。

4. 建立并过滤决策树

按任务实际情况选取分支,不强制全部覆盖:

  1. 问题是否成立,成功意味着什么;
  2. 使用者、利益相关者与决策权;
  3. 范围、明确不做事项与优先级;
  4. 当前流程、现行真相源与主要断点;
  5. 理想主流程、例外、失败与恢复分支;
  6. 角色、权限、审批和通知;
  7. 数据来源、字段口径、更新方式与质量标准;
  8. 产物、界面、报表、文档或对外表达;
  9. 依赖、集成、迁移、兼容与回滚;
  10. 成本、时间、注意力、安全、合规和其他约束;
  11. 阶段划分、停车闸、验收证据与失败兜底;
  12. 交付后的所有权、维护、监控和退役。

逐个分支按“先研究再判断”处理。提问须同时满足:

  1. 自行调查、必要的安全最小试验、有效的既有决定或可靠默认仍不足以解决;
  2. 不同答案会明显改变目标、范围、优先级、成本、风险、授权边界或验收标准;
  3. 仍需用户提供独有信息、明确未定的意图或价值取舍、决定风险接受程度,或补充当前动作缺少的授权。

任一条件不满足,就不提问。调查或试验失败不自动转为询问用户技术事实:保留待验证项或阻塞、说明影响,继续可行的部分。不能因“技术问题”忽略数据完整性、不可逆操作或客户承诺的高影响后果,也不能因“业务偏好”重复询问已有决定。

5. 按三档处理

高影响且必须由用户决定

先给当前主题的结论、必要事实、推荐和主要取舍,再提出需要用户决定的事项。两三个紧密关联、没有未解决上游依赖的点可以一起讨论;跨主题或依赖当前答案的事项留到后续轮次。不要叠加固定“局部结论卡+问题卡”,重复推荐和理由。需要比较时给真实选项,也允许用户自定义答案;收到回应后再推进需要该决定的内容。

有逻辑关联但可以安全默认

记入决策账本,只在影响当前理解时简述默认方案及理由。不逐项展示“默认继续”卡片,不索取确认,继续授权范围内的研究。

纯低影响细节

不打断访谈,不逐项展示。直接记入默认决策账本,在阶段小结或最终规划中集中披露;如果后续证据表明它会造成高影响后果,再重新分级。

6. 执行高影响决策循环

收到回答后更新目标、决定及理由、范围和关键约束,检查是否推翻旧假设、产生新分支或与旧答案冲突。发生重要变化、信息已足够或继续追问收益降低时,重新评估剩余问题;只追问仍满足准入条件、会改变行动的事项,不按回答轮数计数。

阶段小结只报告影响理解的新增决定、变化和剩余问题;无实质变化不复述。剩余事项可安全默认、列为待验证项或放入后续停车闸时,立即停止追问。

7. 关闭决策树

只在同时满足以下条件时建议结束访谈:

  • 高影响分支已经确定或明确延后到某个停车闸;
  • 目标、范围、不做事项和优先级没有重大矛盾;
  • 会改变方案的主流程、关键异常和失败兜底已被覆盖;
  • 高影响的依赖、风险、权限、真实写入、数据口径和不可逆动作确认闸已经暴露;
  • 有可观察的完成标准和验收证据;
  • 对真实需求和目标不存在已知的高影响歧义;
  • 剩余未决项不会让当前规划根本改道。

不要求提前确定所有普通实现细节;界面、措辞或技术实现一旦会影响客户承诺、关键操作、数据完整性、风险、授权或验收,仍按实际后果提升为高影响问题。

满足条件后简短收口,说明结果、关键已定事项和剩余问题;决策账本保留目标、范围、用户决策、AI 默认、待验证项、停车闸和验收口径,不将整份账本重复展示。无需逐项确认。按明确请求提供完整产物;没有请求时不自动展开规划或候选 Goal。新的高影响问题按准入条件处理,新的规则冲突按专门停止闸处理。

按模式交付与执行

默认简短收口;用户明确索要完整规划或执行任务书时,使用对应模板,章节按需选用与合并。用户同时要求两者时,以已确认规划派生任务书。

只有用户明确索要候选 Goal 时才提供该文本,并标为 CANDIDATE / NOT_AUTHORIZED。普通讨论和完整规划不强制追加授权声明或候选标记;只在真实授权歧义、转入实施或需要明确产物边界时说明。

仅生成未获执行授权的任务书时,以 CANDIDATE / NOT_AUTHORIZED 收尾,不附自动执行命令;已有实施授权的交接如实记录授权与边界。生成阶段不创建正式任务或 Goal,不实施任务书。

普通“开始”或“执行”在当前上下文已明确具体批次且授权完整时,默认在当前任务连续完成修改、验证与交付;不强制派生任务书、重选执行方式或另开任务。只有用户明确要求另开正式任务,才进入独立任务流程;已有独立执行任务时按交接规则接续。当前任务需要独立检查时可使用内部只读代理;仅请求 Goal 不等于另开任务授权,按宿主 Goal 规则处理。

与其他 Skill 的边界

  • 本 Skill 是公开的需求研究、规划和执行任务书统一入口;任务书能力已内建,不再分流到另一个公开入口。
  • /提示词增强 负责整理用户已经表达出来的需求,不负责长时问答挖掘未表达需求。
  • 正式实施、成果落盘、发布或写入外部系统属于生成阶段结束后的已授权活动,按上述分流决定承接入口,仍遵守当前项目授权和硬边界;生成任务书不扩大授权,也不要求因此另开正式任务。

使用中持续成长

仅有可复用的新反馈、有效方法或改进机会时,先区分 Skill 缺陷、执行未遵守、材料不足与环境限制,沿已有授权低成本查证;不为成长另启后台任务或强制复盘,无新价值不增检索、记录或报告。方法经验只在用户已授权且项目已指定的位置,补入既有方法记录的相关主题;保存来源、适用条件、结果与验证状态,已有证据只引用,同一发现不重复保存。未指定位置、明确只读、禁写或权限不足时,仅在对话中说明,不自动创建经验库或规则。相关问题才定向回读,经验不自动成为执行指令;正式改进准备具体差异、收益成本及验证、回退办法,按当前用户和项目规则取得批准,同批不重复确认。研究阶段仍只在对话保留发现;已有实施授权时才按上述位置留证。

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.