dart-docs-update
GitHub用于执行DART项目的文档和AI指令更新工作流。支持创建分支、编辑文档源文件、同步AI命令、分类文档、更新索引及运行验证检查，最终提交PR。
Trigger Scenarios
Install
npx skills add dartsim/dart --skill dart-docs-update -g -y
SKILL.md
Frontmatter
{
"name": "dart-docs-update",
"description": "DART Docs Update: update docs or AI instruction visibility without code changes"
}
dart-docs-update
Use this skill to run the DART dart-docs-update workflow. The editable workflow
source lives in .claude/commands/; this generated skill is its entrypoint for
Codex and Muse.
Invocation
- Claude Code:
/dart-docs-update <arguments> - Codex:
$dart-docs-update <arguments> - Muse:
/dart-docs-update <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
Update documentation: $ARGUMENTS
Required Reading
@AGENTS.md @docs/README.md @docs/AGENTS.md @docs/information-architecture.md @docs/ai/principles.md @docs/ai/verification.md @docs/onboarding/ai-tools.md @docs/onboarding/changelog.md
Workflow
- Create a branch from the target branch, for example:
git switch --no-track -c docs/<topic> origin/main - Edit docs and AI workflow sources only:
- Regular docs:
docs/**,README.md,AGENTS.md,CONTRIBUTING.md - AI source files:
.claude/commands/**,.claude/skills/**
- Regular docs:
- For AI workflow changes, run
pixi run sync-ai-commands; do not hand-edit manifest-owned.agents/skills/paths..codex/is maintained runtime configuration. - Classify new or moved docs by lifecycle first, then audience, then topic,
using
docs/information-architecture.md - Update indexes and cross-references that point to changed docs. For AI docs, keep always-loaded entrypoints compact: improve owner placement or pointers instead of duplicating procedures.
- Use
docs/ai/verification.mdto select the docs-only or AI docs/adapters gate set, then runpixi run lintbefore committing - Record the
CHANGELOG.mddecision usingdocs/onboarding/changelog.md. - Ask for explicit maintainer/user approval before pushing or opening the PR.
After approval, push with the same local and remote topic-branch name, use
.github/PULL_REQUEST_TEMPLATE.md, and set the proper milestone.
Output
- Docs changed and why
- Verification commands run (docs/AI checks) and their results
- Any external mutation left pending explicit approval
Version History
-
f630c91
Current 2026-10-18 20:24
新增对Muse客户端的支持；移除已废弃的OpenCode和Gemini支持；主开发分支从release-6.19切换至main。
-
deb9869
2026-09-08 21:45
新增audit模式支持检查架构映射漂移；更新触发工具列表移除OpenCode；调整必读文档路径。
- bcd584e 2026-09-02 23:40
- b9fbefc 2026-07-19 11:29
