القائمة
Troubleshoot validation, build, and Docker. Use when the user has validation errors, build failures, Docker issues, or questions about running validate, build, or serve.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Answer help questions and route users. Use when the user says help, how do I, what is HALOS, or asks about contributing, validating, proposing, or understanding the spec.
Help draft and structure proposals. Use when the user wants to write a proposal, submit a framework change, extend the spec, or needs guidance on the proposal process.
Explain HALOS in plain language. Use when the user asks about a core requirement, principle, how to adopt HALOS, or interpretation of the spec.
Seek out and update agent discovery files as conventions evolve. Use when agent ecosystems add new ways to state behavior, skills, or rules; when discovery files need revision; or when maintaining FOR_AGENTS.md, .cursorrules, docs/for-agents.md, docs/agent-discovery.md.
| name | validation-and-build |
| description | Troubleshoot validation, build, and Docker. Use when the user has validation errors, build failures, Docker issues, or questions about running validate, build, or serve. |
Help users validate the spec, build the site, and use Docker. Per halos-repo-operations, run validation and build before committing.
Docker (recommended):
docker run --rm halos validate
# With local changes:
docker run --rm -v "$(pwd):/workspace" halos validate
Local:
npx --yes ajv-cli validate --spec=draft2020 -s spec/schema/manifest.schema.json -d spec/manifest.json
npx --yes ajv-cli validate --spec=draft2020 -s spec/schema/core.schema.json -d spec/core.json
npx --yes ajv-cli validate --spec=draft2020 -s spec/schema/changelog.schema.json -d spec/changelog.json
node scripts/validate-spec-immutability.js origin/main
node scripts/generate-spec.js
test -s spec/spec.md && test -s spec/CHANGELOG.md
Pre-push immutability check:
node scripts/validate-spec-immutability.js origin/main
node scripts/generate-spec.js after JSON editsnode scripts/generate-spec.js from repo rootnpx --yes ajv-cli or Docker# Build site
docker run --rm halos build
# Serve (builds then serves on 3000)
docker run --rm -p 3000:3000 halos serve
# Info (version, bundled vs mounted)
docker run --rm halos info
./scripts/serve.sh
Requires: Jekyll, Python 3. Copies spec and agents into docs, runs jekyll build, serves docs/_site on port 3000.
./scripts/integration-test.sh
Spins up the site in Docker, checks all paths (200s, expected content), verifies 404 for unknown paths. Run before committing or deploying. CI runs this as a pre-deploy gate.
Per halos-repo-operations: