ai-catapult-init
Bootstrap AI-ready governance, traceability, cascade, catalog audits, and validation. Use when setting up AI SDLC; aliases: init-ai-repo and ai-sdlc-init.
- License 许可
- Apache-2.0
- 所属仓库
- r3dlex/skills
- 最近更新
- 2026-10-29
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- ai-catapult-init
- description
- Bootstrap AI-ready governance, traceability, cascade, catalog audits, and validation. Use when setting up AI SDLC; aliases: init-ai-repo and ai-sdlc-init.
02 资源文件 86
- 资产文件assets/readme/template.md328 B
- 参考文档modules/archgate.md1.3 KB
- 参考文档modules/brd-prd-traceability.md2.6 KB
- 参考文档modules/cascade.md8.0 KB
- 参考文档modules/ci-adapters.md1.9 KB
- 参考文档modules/ci-policy.md7.5 KB
- 参考文档modules/documentation-blueprint.md14.1 KB
- 参考文档modules/evals.md4.9 KB
- 参考文档modules/foundation.md1.1 KB
- 参考文档modules/graph-automation.md7.0 KB
- 参考文档modules/host-policy-automation.md13.1 KB
- 参考文档modules/knowledge-publish.md11.7 KB
- 参考文档modules/language-packs.md5.9 KB
- 参考文档modules/mcp-a2a.md3.2 KB
- 参考文档modules/memory.md4.6 KB
- 参考文档modules/migration.md7.5 KB
- 参考文档modules/phases/01-discover-decide.md1.4 KB
- 参考文档modules/phases/README.md1.8 KB
- 参考文档modules/readme-documentation.md10.9 KB
- 参考文档modules/README.md4.8 KB
- 参考文档modules/release-versioning.md16.0 KB
- 参考文档modules/skill-modernization.md5.2 KB
- 参考文档modules/sync.md5.7 KB
- 参考文档modules/topology.md8.6 KB
- 参考文档modules/traceability.md7.1 KB
- 参考文档modules/tracker-adapters.md3.8 KB
- 参考文档modules/validation.md23.7 KB
- 参考文档modules/workflow.md7.5 KB
- 参考文档REFERENCE.md42.5 KB
- 脚本scripts/lib/invoked.d.mts67 B
- 脚本scripts/lib/invoked.mjs327 B
- 脚本scripts/lib/node-version.d.mts514 B
- 脚本scripts/lib/node-version.mjs860 B
- 脚本scripts/lib/readme-generate.d.mts78 B
- 脚本scripts/lib/readme-generate.mjs20.1 KB
- 脚本scripts/lib/readme-generate.mjs.map8.8 KB
- 脚本scripts/lib/repo-root.mjs229 B
- 脚本scripts/readme-generate.sh1.3 KB
- 参考文档templates/AGENTS.md2.7 KB
- 参考文档templates/boundary-manifest.json16.4 KB
- 其他templates/ci/ado/azure-pipelines.yml.template1.3 KB
- 其他templates/ci/github/dpua-validation.yml.template1.8 KB
- 其他templates/ci/gitlab/dpua-child.yml.template516 B
- 其他templates/ci/gitlab/gitlab-ci.yml.template425 B
- 参考文档templates/CLAUDE.md91 B
- 其他templates/dot-ai/drift/backups/.gitkeep—
- 参考文档templates/dot-ai/drift/last-drift.json176 B
- 其他templates/dot-ai/evals/.gitkeep—
- 参考文档templates/dot-ai/evals/coverage-exceptions.json3 B
- 参考文档templates/dot-ai/execution/child-binding.schema.json2.6 KB
- 参考文档templates/dot-ai/execution/execution-profile.schema.json9.3 KB
- 参考文档templates/dot-ai/execution/matrix-v1.1.schema.json6.8 KB
- 参考文档templates/dot-ai/execution/profiles/execution/default.json2.2 KB
- 其他templates/dot-ai/handoff/.gitkeep—
- 其他templates/dot-ai/knowledge/entries/.gitkeep—
- 参考文档templates/dot-ai/knowledge/registry.json129 B
- 参考文档templates/dot-ai/matrix.json454 B
- 参考文档templates/dot-ai/mcp/a2a-handoff.md1.7 KB
- 参考文档templates/dot-ai/mcp/registry.json743 B
- 参考文档templates/dot-ai/observability/audit-checklist.md1.3 KB
- 参考文档templates/dot-ai/observability/conventions.md1.5 KB
- 参考文档templates/dot-ai/phases/01-discover-decide/status.json407 B
- 参考文档templates/dot-ai/phases/02-govern-plan/status.json391 B
- 参考文档templates/dot-ai/phases/03-configure-generate/status.json511 B
- 参考文档templates/dot-ai/phases/04-validate-handoff/status.json457 B
- 参考文档templates/dot-ai/policies/model-routing.json1.7 KB
- 参考文档templates/dot-ai/policies/readiness-policy.json2.7 KB
- 参考文档templates/dot-ai/reviews/ai-failure-modes.md1.6 KB
- 参考文档templates/dot-ai/rules/security.md1.5 KB
- 参考文档templates/dot-ai/rules/technical-bounds.md1.6 KB
- 参考文档templates/dot-ai/skills/git-ops.json210 B
- 参考文档templates/dot-ai/skills/workspace-sync.json167 B
- 参考文档templates/dot-ai/system-prompts/architect.md1.2 KB
- 参考文档templates/dot-ai/system-prompts/developer.md1.2 KB
- 参考文档templates/dot-ai/system-prompts/qa-engineer.md1.1 KB
- 其他templates/dot-ai/traceability/.gitkeep—
- 参考文档templates/dot-ai/workflows/repo-workflow.json1.1 KB
- 参考文档templates/dot-ai/workflows/repo-workflow.md1.7 KB
- 参考文档templates/dot-github/workflows/ci-prek.yml355 B
- 脚本templates/dot-rules.ts7.6 KB
- 参考文档templates/GEMINI.md91 B
- 参考文档templates/graph-automation/config.json571 B
- 脚本templates/graph-automation/graph-refresh.sh12.8 KB
- 参考文档templates/graph-automation/harness-hooks.json1.8 KB
- 脚本templates/graph-automation/hook-body.sh1.0 KB
- 其他templates/prek.toml369 B
03 SKILL.md 正文
Init AI Repo
Quick Start
Run this skill in the target repo. ai-catapult-init is the canonical skill name; init-ai-repo and ai-sdlc-init remain deprecated compatibility aliases. Use dry-run first when scope or host choices are unclear. Keep hosted settings as checklist output unless the user explicitly requests an admin/credentialed action.
Workflow
Phase 1 — Discover & Decide
Inspect repository state, host tooling, trackers, CI, and runtime conventions. Choose greenfield bootstrap, brownfield adoption, hosted-tracker-first, or local fallback. Emit .ai/matrix.json, .ai/init/repo-profile.json, .ai/init/sdlc-path.md, and .ai/phases/01-discover-decide/. OMX surfaces: $deep-interview, $plan, $ralplan; OMC surfaces must produce the same artifact contract.
Phase 2 — Govern & Plan
Generate or refresh AGENTS.md, RULES.md, PLANS.md, CONTRIBUTING.md, active/archived specs, ADRs, .ai/work-intake/, .ai/plans/, and .ai/phases/02-govern-plan/. Ensure a hosted issue/ticket when configured and authorized. Local fallback is allowed before coding, but it must be reconciled before final PR merge. Require active spec/PRD, plan, and acceptance criteria before implementation.
Phase 3 — Configure & Generate
Generate command/runtime surfaces and policy automation under .ai/bin/, .ai/policies/, .ai/commands/omx/, .ai/commands/omc/, .ai/language-packs/, optional Makefile/justfile, and .ai/phases/03-configure-generate/. OMX surfaces: $ralph, $team, $ultragoal, $ultrawork; OMC aliases/commands delegate to the same generated structures rather than duplicate semantics.
Phase 4 — Validate & Handoff
Run local validation, drift checks, generated smoke tests, and hosted/local ticket reconciliation. Emit .ai/validation/report.md, .ai/drift/migration-manifest.json, .ai/handoff/init-ai-repo-handoff.md, and .ai/phases/04-validate-handoff/. OMX surfaces: $doctor, $code-review, $team, $ralph. The handoff records done, verified, remaining, and reconciliation status.
Internal checkpoints
The public workflow is four phases, but the generator preserves the original eight internal checkpoints for compatibility and traceability:
- Detect repo state
- Choose SDLC path
- Scaffold foundation and v3 layout
- Scaffold work intake
- Configure host adapters
- Configure CI and policy
- Select language packs
- Validate and emit handoff
PR Merge Gate
Every implementation initialized by this skill must assume protected main and PR-only delivery. Emit provider-specific branch-policy checklist/config artifacts unless the user explicitly authorizes hosted mutation with credentials. Admin users may self-approve only when host policy permits it and the host/runtime explicitly supports an admin approve/admin bypass lane for the same actor; all required checks must still pass. If the host rejects same-actor review approval (for example, GitHub hosted PR review), use a distinct admin reviewer or explicit host admin bypass/admin merge. Record the actor, authority, reason, checks, and approval mode, and fail closed when same-actor admin approval support cannot be proven.
When this skill creates or updates PR workflow guidance, require merge only after:
- The architect confirms the implementation still matches ADRs, module boundaries, branch policy, and acceptance criteria.
- The reviewer confirms code quality, safety, documentation, and drift checks have no blocking findings.
- The executor confirms the requested change is implemented, cleanup is complete, and all required checks are green.
- All actionable PR comments are resolved and local CI plus host SCM CI (GitHub Actions, Azure Pipelines, or GitLab CI as applicable) are green.
- The loop reaches explicit agreement across architect, reviewer, and executor; if any role disagrees, comments remain actionable, checks are not green, or branch policy forbids merge, do not merge or auto-merge.
modules/ci-policy.md adds a mechanical eval-coverage check to this PR merge gate: a changed shippable skill must declare a structurally valid evalset. See modules/evals.md.
Module Map
modules/README.md— read when choosing which Layer 3 module applies.modules/phases/README.md— read when mapping the four public phases to internal checkpoints.modules/topology.md— read when generating.ai/matrix.jsonor validating umbrella depth.modules/ci-adapters.md— read when an umbrella renders selected GitHub, ADO, or GitLab CI from its execution profile.modules/documentation-blueprint.md— read when generating the v3.ai/,.memory/, anddocs/trees.modules/memory.md— read when defining.memory/human-override/and.memory/self-learnedschemas.modules/sync.md— read when implementing physical-copy sync and drift detection.modules/host-policy-automation.md— read when applying hosted branch/PR/policy mutations safely.modules/validation.md— read when validating generated artifacts, depth rules, and golden fixtures.REFERENCE.md— read only for legacy full template bodies that have not yet moved into focused modules.modules/readme-documentation.md— read when initializing, augmenting, or rewritingREADME.md.modules/release-versioning.md— read when initializing release tagging, versioning, or CI/CD release workflows.modules/workflow.md— read when generating repo workflow docs, workflow/status manifests, entry-surface links, and handoff indexes.modules/traceability.md— read when generating stable traceability IDs, graph schema, backlink validation, graph fixtures, or cross-skill requirement/work-artifact links.modules/cascade.md— read when generating multi-repo cascade plans, first-run confirmation gates, idempotent linked updates, host adapter contracts, audits, and reconciliation reports.modules/skill-modernization.md— read when auditing compact descriptions, progressive disclosure, trigger boundaries, cross-skill links, and AI-SDLC compatibility.modules/evals.md— read when generating the.ai/evals/scaffold or the offline eval-coverage gate thatmodules/ci-policy.mdadds to the PR merge gate.modules/mcp-a2a.md— read when generating the.ai/mcp/registry stub and the A2A cross-agent handoff convention.modules/graph-automation.md— read when scaffolding automatic background knowledge-graph refresh via git hooks and harness hooks; covers the lock+coalesce wrapper, engine knob (default graphify, alternative graphwiki), hook-body contract, andai-catapult graph-hooks install.
Safety Rules
- Keep
SKILL.mdunder 100 body lines; move variants to modules. - Treat GitHub/ADO/GitLab/Jira branch and policy settings as confirmation-gated mutations; do not apply them without explicit opt-in even with admin credentials.
- Reference
setup-skillsandpublish-semverhost docs instead of copying their full semantics. - Preserve existing GitLab/local support unless a later module explicitly migrates it.
- Physical-copy is the canonical sync strategy; symlinks and git submodules are not.
04 同仓库更多 Skills
skill
Fixture.
stable-skill
Fixture stable-skill.
experimental-skill
Fixture experimental-skill.
deprecated-skill
Fixture deprecated-skill.
karpathy-guidelines
Apply think-before-coding, simplicity, surgical-change, and goal-driven engineering rules. Use when planning, implementing, or reviewing code.
karpathy-guidelines
Apply think-before-coding, simplicity, surgical-change, and goal-driven engineering rules. Use when planning, implementing, or reviewing code.