create-research
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseCreate Research
创建调研
Build a self-contained explanation of the repository as it exists at the researched commit. The
default product is a technical map: what exists, where it lives, how it behaves, how its parts
connect, and how that behavior is tested.
Recommendations, redesigns, implementation proposals, critiques, and causal diagnosis are separate
assignments. Include one only when the user explicitly puts it in scope, and label it apart from
the current-state findings.
针对仓库在所调研 commit 时对应的状态,编写一份自包含的说明。默认产物是一份技术图谱:包含现有内容、所在位置、行为方式、组成部分之间的连接,以及这些行为的测试方式。
建议、重新设计、实现方案、评审意见和因果诊断均属于独立任务。只有当用户明确将其纳入范围时,才可纳入相应内容,并应将其与当前状态的发现分开标注。
Process
流程
1. Resolve the inquiry
1. 确定调研事项
Read the research protocol in full before exploring. It defines
the direct-question, artifact, codebase, dependency, web, and follow-up branches; the protected-file
boundary; source precedence; delegation; artifact placement; and permalink rules.
Use the user's stated question as controlling input. If the system supplies a task artifact
directory, inspect it exactly as the protocol requires. Read every directly named input file in
full in the main context before delegating any work.
Create a coverage ledger with one row per question and columns for research area, required evidence,
test evidence, assigned investigator, and status.
This step is complete when exactly one inquiry is in scope, all authorized inputs have been read,
and every question has a ledger row. If the available inputs are ambiguous, ask the protocol's
single selection question and stop.
在探索之前,完整阅读调研协议。其中定义了直接问题、产物、代码库、依赖、Web 和后续跟进等分支;受保护文件边界;来源优先级;委派机制;产物放置规则;以及永久链接规则。
以用户提出的问题作为控制性输入。如果系统提供了任务产物目录,则严格按照协议要求进行检查。在委派任何工作之前,在主上下文中完整读取每一个直接指定的输入文件。
创建一个覆盖清单,每个问题占一行,列包括调研领域、所需证据、测试证据、指定的调查者和状态。
当且仅当范围内恰好有一个调研事项、所有获准输入均已读取,且每个问题都有一行清单记录时,此步骤才算完成。如果可用输入存在歧义,则提出协议规定的唯一选择问题并停止。
2. Design the investigation
2. 设计调研
Split the ledger into cohesive areas that can produce independently checkable findings. Mark
dependencies between areas so discovery work precedes analysis that needs its results. Choose the
applicable investigator roles and tool branches from the protocol; the skill must remain executable
when named specialists or delegation tools are absent.
This step is complete when every ledger row belongs to at least one bounded investigation, each
investigation names its expected evidence and testing coverage, and dependent work is ordered.
将清单拆分为内聚的调研领域,使每个领域都能产生可独立核验的发现。标记领域之间的依赖关系,确保发现工作先于依赖其结果的分析。按照协议选择适用的调查者角色和工具分支;即使缺少指定的专家或委派工具,skill 也必须能够执行。
当每个清单记录都属于至少一个边界明确的调研、每项调研都列明预期证据和测试覆盖范围,并且依赖工作已排序时,此步骤才算完成。
3. Collect evidence
3. 收集证据
Run independent investigations concurrently and dependent investigations in waves. Keep every
investigator read-only and require paths with line ranges, relevant symbols or entry points,
connections to adjacent components, test locations and methods, uncertainties, and external links
when web or dependency sources are used.
Wait for every dispatched investigation. Reconcile overlaps against live repository evidence and
record conflicts instead of silently choosing or averaging them.
This step is complete when each ledger row contains traceable evidence or states the exact evidence
that could not be found and why that gap matters to the question.
并行执行相互独立的调研,并按波次执行存在依赖关系的调研。要求所有调查者保持只读,并提供带行号范围的路径、相关符号或入口点、与相邻组件的连接关系、测试位置和方法、不确定项;在使用 Web 或依赖项来源时,还需提供外部链接。
等待所有已分派的调研结束。根据当前仓库中的实际证据核对重叠内容并记录冲突,而不是在未说明的情况下选择其中一种或取平均值。
当每个清单记录都包含可追溯的证据,或明确说明无法找到的具体证据及其缺口为何对问题很重要时,此步骤才算完成。
4. Build the explanation
4. 构建说明
Before drafting, read the report standard in full. Synthesize by
concept and behavior, not by investigator or file. Connect boundaries and data/control flow, and
document the testing pattern beneath every component area—including an explicit finding when no
test evidence exists.
This step is complete when every material claim is traceable, every original question is answered
or precisely unresolved, cross-component connections are explained, and every finding satisfies
the report standard.
起草前,完整阅读报告标准。按概念和行为进行综合,而不是按调查者或文件进行综合。说明边界以及数据/控制流,并记录每个组件领域之下的测试模式;如果不存在测试证据,也要明确说明这一发现。
当每项实质性论断都可追溯、每个原始问题均已回答或被明确保留为未解决、跨组件连接已得到解释,且每项发现均符合报告标准时,此步骤才算完成。
5. Write and close the artifact
5. 编写并完成产物
Gather repository metadata and choose the destination before drafting, following the artifact rules
in the protocol. Then read the research document template and
write the complete artifact with no placeholder text.
If unresolved questions remain, perform one additional targeted investigation pass after the first
complete draft. Integrate answers into their proper sections and remove resolved entries; retain
the remaining entries as explicit open questions. Do not add a second research appendix.
This step is complete when the artifact path and chronological prefix are valid, metadata reflects
the researched snapshot, every required section is populated, and the coverage ledger has no
unclassified or silently omitted row.
起草前收集仓库元数据,并按照协议中的产物规则选择存放位置。然后阅读调研文档模板,编写完整产物,不留任何占位文本。
如果仍有未解决的问题,则在第一版完整草稿完成后,再进行一次有针对性的补充调研。将答案整合到相应章节并删除已解决的条目;其余条目保留为明确的开放问题。不要添加第二个调研附录。
当产物路径和时间顺序前缀有效、元数据与调研快照一致、每个必需章节均已填写,且覆盖清单中没有任何未归类或被静默遗漏的记录时,此步骤才算完成。
6. Hand off the result
6. 移交结果
Read the final-answer contract and follow its applicable
branch. Include an artifact link when the host provides one; otherwise provide its local path.
Include durable source permalinks only when the protocol's reachability check passes.
For later questions about the same inquiry, update this artifact in place. Expand or correct the
relevant findings and references rather than appending an unintegrated answer dump.
This step is complete when the user can open the artifact, see whether any question remains open,
and identify the next available workflow action.
阅读最终答复约定,并遵循其中适用的分支。如果宿主环境提供产物链接,则包含该链接;否则提供其本地路径。仅当协议的可达性检查通过时,才包含持久有效的源永久链接。
对于同一调研事项的后续问题,请就地更新产物。扩展或修正相关发现和引用,而不是附加未整合的答案堆砌。
当用户可以打开产物、查看是否仍有开放问题,并确定下一步可用的工作流操作时,此步骤才算完成。