research
Investigate a question against high-trust primary sources and capture the findings as a cited Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to an isolated agent.
- License 许可
- MIT
- 最近更新
- 2026-08-28
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- research
- description
- Investigate a question against high-trust primary sources and capture the findings as a cited Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to an isolated agent.
02 资源文件 1
- 参考文档agents/openai.yaml94 B
03 SKILL.md 正文
Delegate the research to the Pi researcher agent so the reading happens in an isolated context. The parent waits for the dispatch to finish; this is not a detached background job.
Process
- Decide where the repository keeps research notes. Match an existing convention. If none exists, choose a sensible final path and state it.
- Create a unique scratch directory at
.scratch/pi-agents/research-<timestamp>/and assignresearch.mdas the agent's only writable artifact. - Capture
git status --short, then invoke the Pisubagenttool with oneruns.runchild using agentresearcher,context: "fresh",worktree: false, andasync: false. Include:- The exact research question and practical decision it informs.
- Relevant repository paths and version constraints.
- The scratch artifact's exact path.
- The final destination you intend to use after validation.
- The researcher must investigate primary sources such as official documentation, source code, specifications, and first-party APIs. Every material factual claim needs a citation to the source that owns it.
- After delegation, compare
git status --shortwith the captured state. The only new path attributable to the researcher must be the assigned scratch artifact. Stop and report any unexpected change. - Read the complete artifact. Check that it answers the question, separates fact from inference, cites every material claim, and records uncertainty.
- Promote the validated report to the chosen final path. The parent performs this write so an existing project document is never replaced without review. Report both the final path and the scratch source.
If the subagent tool is unavailable, perform the same research in the current session and write the final artifact directly. Disclose that the research was not context-isolated.
04 同仓库更多 Skills
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
wait-what
Stop. That last message did not land: re-pitch it.
to-questionnaire
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
teach
Teach the user a new skill or concept, within this workspace.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
grilling
Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.