Menu
Create or update docs/ARTIFACT_NORMS.md from an approved proposal and establish project docs norms as canonical rules.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | define-docs-norms |
| description | Create or update docs/ARTIFACT_NORMS.md from an approved proposal and establish project docs norms as canonical rules. |
| description_zh | 基于已确认提案创建或更新 docs/ARTIFACT_NORMS.md，建立项目文档规范的单一权威来源。 |
| tags | ["documentation","workflow"] |
| version | 3.0.0 |
| license | MIT |
| recommended_scope | project |
| metadata | {"author":"ai-cortex"} |
| triggers | ["define docs norms","create docs norms","apply norms"] |
| input_schema | {"type":"free-form","description":"Approved norms proposal, optional existing ARTIFACT_NORMS.md, optional merge strategy"} |
| output_schema | {"type":"document-artifact","description":"Canonical docs norms file","artifact_type":"governance","path_pattern":"docs/ARTIFACT_NORMS.md","lifecycle":"living"} |
将已审阅的规范提案固化为 docs/ARTIFACT_NORMS.md，并作为项目文档治理的 canonical 规则。
首要目标：安全、可审计地创建或更新项目规范文件。
成功标准（必须全部满足）：
docs/ARTIFACT_NORMS.mdrules/doc-health-criteria.md）验收测试：规范文件是否可直接作为路径/命名/front-matter 校验依据，并被其他技能稳定解析？
本技能负责：
docs/ARTIFACT_NORMS.md本技能不负责：
rules/repo-structure-hygiene.md，由 AgentFabric runtime 或人工执行）交接点：规范写入后，结构整改与合规检测由 runtime / linter / CI 工具按 rules/repo-structure-hygiene.md 与 rules/doc-health-criteria.md 执行。
ARTIFACT_NORMSdocs/calibration/docs-norms-proposal.md）docs/ARTIFACT_NORMS.mdcreate | merge | replacedocs/ARTIFACT_NORMS.mdrules/repo-structure-hygiene.md 整理 + rules/doc-health-criteria.md 合规检测docs/ARTIFACT_NORMS.mdcreate|merge|replace）docs/ARTIFACT_NORMS.md不要做这些（其他技能负责）：
rules/doc-health-criteria.md）rules/repo-structure-hygiene.md 执行docs/ARTIFACT_NORMS.mddocs/calibration/docs-norms-proposal.mdcreatedocs/ARTIFACT_NORMS.mdmergeStore, look up, or delete a personal credential (server SSH password, database password, website login, API key/token, certificate passphrase) in the macOS Keychain using a consistent <project>-<env>-<kind> naming scheme, and optionally record a pointer (never the secret itself) in the current project's Claude Code memory. Always use this skill whenever the user asks to save, store, remember, look up, rotate, or delete a password, API key, token, SSH credential, or database credential on this machine — even if they don't say "Keychain" or "security" explicitly, e.g. "save this database password so I don't lose it", "把这个数据库密码存一下", "记一条密钥", "这台服务器的密码帮我记下来", "what's the postgres password for staging again", "delete the old GitHub token from keychain". Do not use this for team-shared secret vaults, CI/CD secret injection, or anything that needs to sync across machines — those need a real secrets manager, not this skill.
Drain pending NATS messages from a producer contract via NATS MCP tools. Discovers the available NATS tool capabilities, selects exact-subject or wildcard mode from .cortex/nats.yaml, applies Tolerant Reader semantics, executes ack/nak/term decisions, and returns aggregated stats.
Audit and refactor existing SKILLs to meet spec compliance, repository asset boundaries, tool adaptation requirements, and LLM best practices.
From inside a linked worktree, deliver the current feature branch into main — merge with --no-ff, push, and optionally clean up the worktree, all without leaving CWD.
After code changes, auto-detect the project's build system and local deployment method for a given directory, then build the project and restart its locally-deployed environment (Docker Compose / systemd / process manager). Never assumes — asks only when detection is ambiguous. Caches detected commands per project in .cortex/redeploy-local.yaml; re-invocations on the same project skip re-scanning until signal files change, the cache expires (30 days), or the skill version bumps.
From the main repo on the main branch, scan all linked worktrees and local branches, let the user multi-select, then merge --no-ff + push them sequentially and clean up succeeded worktrees together.