nextclaw-agent-instructions-governance
Skill263 starsChanged 39 days agoMITView on GitHub
当确定要修改 AGENTS.md、commands、项目 AI 规则、skill/references、治理脚本,或明确优化 AI 驱动开发体系时使用;普通规则讨论和一次性纠偏不提前触发。
In this repository37 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .cursor/rules/code-citation-clickable.mdcCursor rule
- .cursor/rules/commit-message-english.mdcCursor rule
- autonomous-maintainability-campaignSkill
- autonomous-requirement-discoverySkill
- delivering-delegated-linear-issuesSkill
- development-deliverySkill
- development-designSkill
- development-implementationSkill
- development-lifecycleSkill
- development-retrospectiveSkill
- development-reviewSkill
- development-task-understandingSkill
- development-validationSkill
- idea-search-funnelSkill
- nextclaw-product-blog-storytellingSkill
- nextclaw-product-visual-assetsSkill
- x-twitter-birdSkill
- aigen-image-generationSkill
- bb-browserSkill
- browser-controlSkill
- claude-code-narp-runtimeSkill
- clawhub-nextclawSkill
- codex-narp-runtimeSkill
- find-skillsSkill
- gemigo-cliSkill
- impeccableSkill
- lark-cliSkill
- linear-cliSkill
- mmx-cliSkill
- nextclaw-skin-studioSkill
- opencliSkill
- proxy-local-ai-subscriptionsSkill
- publish-to-nextclaw-marketplaceSkill
- skillhub-guideSkill
- superpowersSkill
- ui-ux-pro-maxSkill
The file
Files
AI 指令系统治理
目标
保持规则可靠、单一 owner、渐进加载和低 token 成本。修改前先对齐 docs/VISION.md、检查工作区和当前规则体积,并识别真正根因是缺失、重复、过宽、过长、过期还是放错层。
本项目用户于 2026-09-18 明确授权:开发体系改动完成适用验证与 Review 后,自动按既有交付流程提交、合入 master 并推送 origin/master,无需逐次询问。范围限体系规则、流程、命名治理及其必要文档/测试;不因同批工作区存在产品候选而将其混入,也不自动授权产品部署。用户后续限定优先。
分层
AGENTS.md:每轮必须知道的安全与高层边界。.agents/skills/*/SKILL.md:需要参与初始发现的工作流、阶段或独立任务入口。- skill
references/:仅由一个入口拥有、在子场景成立时读取的合同。 .agents/wiki/skills/<group>/<skill>/SKILL.md:按领域分组、被上层显式加载的完整下级 Skill;不参与初始发现。.agents/wiki/knowledge:事实、背景、案例与权威来源索引;不拥有流程或授权。scripts// tests:高信号、低误报、可确定执行的检查。docs/:人类设计、计划和历史;除非入口明确链接,不承担自动硬规则。
每次触发 skill 都必需的内容保留在入口;单 owner 条件内容进 references;两个以上真实入口共享同一独立合同、或能力需要保留可复用 Skill 身份时进入分组 Wiki Skill。不要用 Wiki 隐藏默认必读合同,也不要把只被一个入口使用的材料升级为共享库。
修改顺序
- 区分个案、重复模式和稳定规则;沉淀层级不得高于证据。找 owner 和相邻规则,优先删除、合并、收窄或移动。
- 每个稳定工作域只有一个 workflow root;普通开发由唯一 lifecycle owner 管理。阶段不直接调用其它阶段或回链,独立 skill 不回链上游。
- description 只描述一个稳定意图,不堆“实现/方案/深入/最佳实践”等泛词抢占触发。
- 一个判断分支最多要求一个直接下游;阶段 Skill、下级 Wiki Skill 与知识都只在当前节点加载。
- 规则影响脚本或命令时同步更新;脚本变化也同步 owning 文本。
- 核心阶段使用统一的
development-<stage>命名;只有深度依赖 NextClaw 产品、NCP、Kernel、仓库命令或发布合同的 skill 使用nextclaw-前缀。 - 大型重构写设计并在同批迭代记录中留痕,小措辞不建日志。
条件方法
- 新增、修订、合并或退役意图宏时,读取意图宏维护;调用只读命中定义,不加载维护合同。
- 用户明确要求优化 AI 驱动开发体系,或有效反馈暴露重复、系统性、高影响机制缺口时,读取开发体系演进闭环。
- 修改、提升、下沉、合并或删除规则资产,或者要标记/复核模型能力补丁时,读取规则资产生命周期。
- 任务明确涉及常驻上下文膨胀、渐进加载、重复读取或 Token 成本时,读取上下文与 Token 治理。
- 新增、删除、合并、分组或下沉 Skill,或改变 workflow/阶段/独立入口拓扑时,读取Skill 拓扑与创建门。
普通局部措辞修正不机械加载多份参考;每次只读取当前判断确实需要的方法,不批量预读。
检查
完成前运行 pnpm check:skill-progressive-loading,确认发现预算、顶层/下级 Skill frontmatter、分组边界、Wiki 非发现性、链接、生命周期拓扑、依赖循环和已删除引用;再按改动风险运行治理 ratchet。纯指令 Markdown 不运行 build/tsc/产品冒烟。
最终报告 AGENTS、skill 数、description、discovery 字符和入口体积变化,说明 Wiki、command/script/baseline 是否适用,以及设计/迭代落点。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

