dart-retro
GitHub执行 DART 回顾工作流，从完成的任务中提取可复用的经验教训。通过审查现有文档、分析工作流摩擦点及失败模式，将通用知识沉淀至指定文档，避免记录 ephemeral 细节，旨在提升未来 AI 代理和贡献者的执行效率与质量。
Trigger Scenarios
Install
npx skills add dartsim/dart --skill dart-retro -g -y
SKILL.md
Frontmatter
{
"name": "dart-retro",
"description": "DART Retro: run a retrospective and capture durable lessons"
}
dart-retro
Use this skill to run the DART dart-retro workflow. The editable workflow
source lives in .claude/commands/; this generated skill is its entrypoint for
Codex and Muse.
Invocation
- Claude Code:
/dart-retro <arguments> - Codex:
$dart-retro <arguments> - Muse:
/dart-retro <arguments>
Treat the text after the skill name, or the user's request when the skill is
loaded on demand, as $ARGUMENTS. When the workflow references $1, $2,
etc., map those to the positional values supplied by the user.
Command Body
Run a retrospective and capture durable lessons: $ARGUMENTS
Required Reading
@AGENTS.md @docs/AGENTS.md @docs/ai/principles.md @docs/ai/components.md @docs/ai/verification.md @docs/onboarding/ai-tools.md
Skip If
Stop without editing when all are true:
- no new patterns, gotchas, or failure modes were discovered
- no workflow improvement is needed
- the learning is too session-specific to help future agents or contributors
- existing docs already cover what happened
- the task was routine and left no durable insight
Workflow
- Search existing branch docs before adding content.
- Inventory the completed work before routing lessons. Consider compatibility, downstream/Gazebo impact, CI/review failure modes, workflow friction, and cleanup or handoff steps separately.
- Decide whether each lesson is general enough for DART AI infra. Do not update AI docs after every session.
- Prefer updating an existing owner doc over adding a new file. Use
docs/information-architecture.mdto choose the owner. - Keep
docs/ai/principles.mdcompact; put procedures in the owner docs it links to. - Avoid ephemeral branch, PR, commit, or username details.
- If adding or renaming a workflow command or skill, edit
.claude/source files and runpixi run sync-ai-commands. - Run
pixi run lintbefore committing. For AI workflow changes, also runpixi run sync-ai-commandsandpixi run check-ai-commands.
Output
- What learning was captured
- Where it was documented
- Checks run
Version History
-
f630c91
Current 2026-10-18 20:25
新增 Muse 客户端支持；细化跳过条件（如常规任务无需记录）；增加对下游影响和 CI 故障模式的考量；明确文档所有权选择规则及同步命令的执行要求。
-
deb9869
2026-09-08 21:46
细化了适用环境（仅Claude Code和Codex），增强了关于成功/失败判定的逻辑，并调整了跳过条件和路由说明。
-
bcd584e
2026-09-02 23:41
将 Claude Code 路由车道升级至 Fable 5.1 并刷新 AI harness
- b9fbefc 2026-07-19 11:30
