Agent Skills › poteto/noodle › reflect

reflect

GitHub

用于会话结束、纠错或获取重要代码库知识后,回顾对话并将经验持久化到知识库、技能文件或结构规则中,以优化后续工作。

.agents/skills/reflect/SKILL.md poteto/noodle

Trigger Scenarios

wrap up conversation after mistakes or corrections significant codebase knowledge gained

Install

npx skills add poteto/noodle --skill reflect -g -y
More Options

Non-standard path

npx skills add https://github.com/poteto/noodle/tree/main/.agents/skills/reflect -g -y

Use without installing

npx skills use poteto/noodle@reflect

指定 Agent (Claude Code)

npx skills add poteto/noodle --skill reflect -a claude-code -g -y

安装 repo 全部 skill

npx skills add poteto/noodle --all -g -y

预览 repo 内 skill

npx skills add poteto/noodle --list

SKILL.md

Frontmatter
{
    "name": "reflect",
    "schedule": "Follow-up stage after quality — capture learnings from the completed execute→quality cycle.",
    "description": "Reflect on the conversation and update the brain. Use when wrapping up, after mistakes or corrections, or when significant codebase knowledge was gained. Triggers: \"reflect\", \"remember this\"."
}

Reflect

Review the conversation and persist learnings — to brain/, to skill files, or as structural enforcement.

Process

Use Tasks to track progress (TaskCreate per step, TaskUpdate to in_progress/completed).

  1. Read brain/index.md to understand what notes already exist
  2. Scan the conversation for:
    • Mistakes made and corrections received
    • User preferences and workflow patterns
    • Codebase knowledge gained (architecture, gotchas, patterns)
    • Tool/library quirks discovered
    • Decisions made and their rationale
    • Friction in skill execution, orchestration, or delegation
    • Repeated manual steps that could be automated or encoded
  3. Skip anything trivial or already captured in existing brain files
  4. Route each learning to the right destination (see Routing below)
  5. Update brain/index.md if any brain files were added or removed

Routing

Not everything belongs in the brain. Route each learning to where it will have the most impact.

Structural enforcement check

Before routing a learning to brain/, ask: can this be a lint rule, script, metadata flag, or runtime check? If yes, encode it structurally and skip the brain note. See brain/principles/encode-lessons-in-structure.md.

Brain files (brain/)

Codebase knowledge, delegation principles, gotchas — anything that informs future sessions. This is the default destination. Use the brain skill for writing conventions.

  • One topic per file. File name = topic slug.
  • Group in directories with index files using [[wikilinks]].
  • No inlined content in index files.

Skill improvements (.agents/skills/<skill>/)

If a learning is about how a specific skill works — its process, prompts, or edge cases — update the skill directly. Use the skill-creator skill for guidelines on effective skill content.

Orchestration workflow improvements

If the session revealed systemic orchestration issues, route to:

  • Brain principle (new delegation heuristic) → brain/delegation/
  • Skill mechanics change (monitoring loop, review step) → relevant skill file
  • New skill opportunity (recurring workflow that could be encoded) → note in summary for the user

Backlog items (brain/todos.md)

Follow-up work that can't be done during reflection — bugs, non-trivial rewrites, tooling gaps. Use the todo skill to file.

Summary

## Reflect Summary
- Brain: [files created/updated, one-line each]
- Skills: [skill files modified, one-line each]
- Structural: [rules/scripts/checks added]
- Todos: [follow-up items filed]

Version History

  • 82d2921 Current 2026-11-19 21:08

Same Skill Collection

.agents/skills/adversarial-review/SKILL.md
.agents/skills/ast-grep/SKILL.md
.agents/skills/brain/SKILL.md
.agents/skills/codex/SKILL.md
.agents/skills/commit/SKILL.md
.agents/skills/debugging/SKILL.md
.agents/skills/execute/SKILL.md
.agents/skills/find-skills/SKILL.md
.agents/skills/frontend-design/SKILL.md
.agents/skills/go-best-practices/SKILL.md
.agents/skills/interaction-design/SKILL.md
.agents/skills/make-interfaces-feel-better/SKILL.md
.agents/skills/meditate/SKILL.md
.agents/skills/noodle/SKILL.md
.agents/skills/oops/SKILL.md
.agents/skills/plan/SKILL.md
.agents/skills/quality/SKILL.md
.agents/skills/react-best-practices/SKILL.md
.agents/skills/refine/SKILL.md
.agents/skills/review/SKILL.md
.agents/skills/ruminate/SKILL.md
.agents/skills/schedule/SKILL.md
.agents/skills/skill-creator/SKILL.md
.agents/skills/testing/SKILL.md
.agents/skills/todo/SKILL.md
.agents/skills/unslop/SKILL.md
.agents/skills/worktree/SKILL.md
examples/minimal/.agents/skills/execute/SKILL.md
examples/minimal/.agents/skills/schedule/SKILL.md
examples/multi-skill/.agents/skills/execute/SKILL.md
examples/multi-skill/.agents/skills/schedule/SKILL.md
skills/skill-creator/SKILL.md
.agents/skills/ts-best-practices/SKILL.md
examples/multi-skill/.agents/skills/deploy/SKILL.md
examples/multi-skill/.agents/skills/test/SKILL.md

Metadata

Files
0
Version
82d2921
Hash
d414a011
Indexed
2026-11-19 21:08

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-20 03:00
浙ICP备14020137号-1