用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/addfox/addfox --skill dev-workflow命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
CI/CD pipeline creation, deployment automation, and troubleshooting for GitHub Actions and GitLab CI. Use when user says "CI pipeline", "CD pipeline", "GitHub Actions", "GitLab CI", "deployment automation", "pipeline debugging", "deployment pipeline", "workflow file".
Codebase statistics and technical debt tracking agent.
Dependency analysis agent for detecting circular dependencies and validating architecture layers.
基于 SOC 职业分类
正在显示 SKILL.md
| name | dev-workflow |
| description | Atomic commits, conventional commit messages, and release management. |
| triggers | ["commit","release","run the workflow","prepare release","atomic commit","version bump","ship it"] |
Ensure proper atomic commits with task traceability, conventional commit messages, and systematic release processes.
CRITICAL: No code changes or commits without a tracked task.
| ID | Rule | Detail |
|---|---|---|
| WF-001 | Task required | No commits without task reference |
| WF-002 | Branch discipline | No commits to main/master |
| WF-003 | Atomic commits | One logical change per commit |
| WF-004 | Conventional format | <type>(<scope>): <description> |
| WF-005 | Tests before push | Relevant tests must pass |
| WF-006 | No auto-commit/push | Generate commands for user to run manually |
<type>(<scope>): <description>
<body explaining why>
Task: #ID
Co-Authored-By: Claude <noreply@anthropic.com>
Example:
fix(auth): prevent token expiry race condition
The refresh token was being invalidated before the new access
token was validated, causing intermittent auth failures.
Task: #1456
Co-Authored-By: Claude <noreply@anthropic.com>
| Type | Description | Test Scope | Version Bump |
|---|---|---|---|
feat | New feature | Related module tests | MINOR |
fix | Bug fix | Regression + affected | PATCH |
docs | Documentation | None (CI validates) | None |
refactor | Code restructure | Affected module tests | PATCH |
test | Test additions | The new tests only | None |
chore | Maintenance | Syntax check only | None |
perf | Performance | Perf tests | PATCH |
security | Security fix | Security tests | PATCH |
Run the full suite locally only for releases, major refactors, cross-cutting changes, or when the user explicitly requests it. Otherwise rely on CI.
TaskList (status: in_progress)git branch --show-currentgit status --porcelain# Targeted (typical)
bats tests/unit/specific-feature.bats
# Syntax check (chore/docs)
bash -n scripts/*.sh lib/*.sh
# Full suite (release/major refactor only)
./tests/run-all-tests.sh
Stage specific files for atomic commits, then display (do not execute) the commit command:
**Commit message:**
type(scope): description
body
Task: #ID
Co-Authored-By: Claude <noreply@anthropic.com>
**To commit, run:**
git add file1 file2
git commit -m "$(cat <<'EOF'
type(scope): description
body
Task: #ID
Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"
Display for the user — do not execute:
git push origin HEAD
./dev/bump-version.sh --dry-run patch # preview
./dev/bump-version.sh patch # execute
./dev/validate-version.sh # validate
git tag -a v${VERSION} -m "${TYPE}: ${SUMMARY}"
git push origin v${VERSION}
git push origin HEAD
# GitHub Actions creates the release automatically
# 1. Ensure all changes merged to main
# 2. Edit CHANGELOG.md with release notes
git add CHANGELOG.md
git commit -m "docs(changelog): Add v0.X.Y release notes"
git push origin main
# 3. (Auto) docs-update.yml creates Mintlify PR → review & merge
# 4. Version bump
./dev/bump-version.sh minor && ./dev/validate-version.sh
git add -A
git commit -m "chore: bump version to v0.X.Y"
git push origin main
# 5. Tag (triggers release.yml)
git tag -a v0.X.Y -m "feat: Description of release"
git push origin v0.X.Y
# → GitHub Actions builds tarball, creates Release, uploads artifacts
| Trigger | Workflow | Actions |
|---|---|---|
| Push/PR to main | ci.yml | Tests, lint, JSON validation, docs drift, install |
| Push to main (CHANGELOG.md) | docs-update.yml | Auto-PR for Mintlify changelog regeneration |
| Tag push (v*..) | release.yml | Build tarball, create GitHub Release, upload |
| Push to docs/ | mintlify-deploy.yml | Validate MDX, check required files |
main → feature/T123-description → PR → main
Subagents share the parent session's branch — all work is sequential, not parallel. Naming: feature/T123-auth-improvements, fix/T456-token-validation.
TaskListbats tests/unit/auth.batsTaskUpdate → status: completedSame flow, but run both unit and integration tests for the feature, and stage test files alongside implementation files.
TaskListSame as bug fix flow, but skip local tests entirely (CI validates).
| Action | Tool | Key Fields |
|---|---|---|
| List tasks | TaskList | — |
| Get details | TaskGet | task ID |
| Create task | TaskCreate | subject, description, activeForm |
| Update task | TaskUpdate | status, addBlockedBy, addBlocks |
| Pattern | Fix |
|---|---|
| No task reference | Create/find task first |
| Committing to main | Use feature branches |
| Running full tests always | Use smart test scope; let CI do the rest |
| Giant commits | One logical change per commit |
| Vague commit messages | Conventional format + task ref |
| Auto-committing/pushing | Generate commands for user to execute |
| Manual release creation | Use tag → GitHub Actions |