new-research
Start a durable research / source note that captures what you read and found — fires on "start a research note", "capture these sources", "log my research". Part of the Agentsmith harness; scaffolds docs/research/<slug>.md so findings live in the repo, never in disposable memory (R9), and are never silently deleted.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 152
- Forks
- 7
01 前言 Front Matter
- name
- new-research
- description
- Start a durable research / source note that captures what you read and found — fires on "start a research note", "capture these sources", "log my research". Part of the Agentsmith harness; scaffolds docs/research/<slug>.md so findings live in the repo, never in disposable memory (R9), and are never silently deleted.
- compatibility
- Requires filesystem access; the fast path requires the cross-platform Agentsmith CLI.
03 SKILL.md 正文
New research note
Research belongs in the repo, traceable to sources, and is never silently deleted (R9). This scaffolds one note per topic.
When this fires
"start a research note" / "capture these sources" / beginning any multi-source investigation whose findings should outlive the session.
Fast path — if the Agentsmith CLI is available
Run agentsmith new-research "topic name" — use .agentsmith/agentsmith on macOS/Linux or
.agentsmith\\agentsmith.cmd on Windows when the command is not on PATH. It slugifies the title and writes
docs/research/<slug>.md from the template (it won't overwrite an existing file).
Fallback — no CLI
- slug = the topic lowercased, every run of non-alphanumeric characters →
-, ends trimmed. - If
docs/research/<slug>.mdalready exists, STOP — append to it, never overwrite. - Otherwise create it with a no-delete banner (obsolete → move to
docs/research/_archive/, R9) and these sections:- Question / scope
- Sources consulted — url or citation; what you actually opened, dated.
- Findings — each traceable to a source above; mark single-sourced / uncertain items.
- Open questions / what was NOT checked.
Report
Name the file created and remind the operator to commit it (R9 — research lives in git, not memory). Every finding you add later must cite a source already in the note.
04 同仓库更多 Skills
portable-fixture
Fixture proving that skill identity comes from metadata rather than its installation path.
portable-fixture
Fixture proving that skill identity comes from metadata rather than its installation path.
writing-rules
Write or review anything an agent reads — a core rule, a profile gate, a SKILL.md description, an instruction-file line, a subagent prompt, a handoff note, a verify-phase label. Part of the Agentsmith harness; supplies the levers that decide whether a line changes behaviour or only costs tokens — the two loads, context pointers, the ladder, completion criteria, leading words, the no-op test. Its default move is deletion, so it earns most on a draft that already exists.
wayfinder
Wayfind a foggy, multi-session effort into an accepted repository spec and separate implementation-ticket drafts. Use when the destination is known but important decisions, dependencies, or scope are not yet clear enough to implement safely.
verify
Answer "is this shippable / done?" with evidence before a commit or PR — fires on "verify", "is this done", "ready to ship?", pre-commit or pre-PR. Part of the Agentsmith harness; runs the project's verify phases and never claims "passing" without showing the output (R5).
new-feedback
Log a harness lesson / post-incident so the SYSTEM improves, not just this one bug — fires on "log a harness lesson", "post-incident", "we should make this less likely", System-Evolution moments. Part of the Agentsmith harness; scaffolds a numbered docs/feedback/NNNN-*.md with the five-stage template (R9 — numbers are never reused).