360 Secure SkillHub
360 安全技能中心

File Placement

该 Skill 以文字规则形式规定文档与脚本的存放位置：.md 文件须放入 docs/ 相应子目录，.sh 脚本须放入 scripts/，禁止在项目根目录或 backend 目录创建（README.md、CLAUDE.md、start.sh 除外），并附带文件名模式到目录的映射参考表。

urbantech
urbantech
热度 45.43
最近更新 2026-05-11 17:35:46
分类：效率依赖：读写文件应用场景：工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add file-placement
Metadata
name
file-placement
description
Enforces ZERO TOLERANCE file placement rules for documentation and scripts. Use when (1) Creating any .md file, (2) Creating any .sh script, (3) Organizing documentation, (4) Writing guides or reports, (5) Adding utility scripts. CRITICAL RULES - NEVER create .md files in root directories (except README.md, CLAUDE.md), NEVER create .sh scripts in backend (except start.sh), ALL documentation goes in docs/ subfolders, ALL scripts go in scripts/ folder.

File Placement Rules

🚨 ZERO TOLERANCE FILE PLACEMENT 🚨

STRICT RULES

  • ❌ FORBIDDEN: Creating .md files in /Users/tobymorning/Desktop/core/ (except README.md, CLAUDE.md)
  • ❌ FORBIDDEN: Creating .md files in /Users/tobymorning/Desktop/core/src/backend/ (except README.md)
  • ❌ FORBIDDEN: Creating .md files in /Users/tobymorning/Desktop/core/AINative-website/ (except README.md, CLAUDE.md)
  • ❌ FORBIDDEN: Creating scripts (.sh) in /Users/tobymorning/Desktop/core/src/backend/ (except start.sh)

REQUIRED LOCATIONS

Backend Documentation → /Users/tobymorning/Desktop/core/docs/

  • Issues/Bugs: docs/issues/ISSUE_*.md, docs/issues/BUG_*.md, docs/issues/ROOT_CAUSE_*.md
  • Testing/QA: docs/testing/*_TEST*.md, docs/testing/QA_*.md
  • Agent Swarm: docs/agent-swarm/AGENT_SWARM_*.md, docs/agent-swarm/WORKFLOW_*.md, docs/agent-swarm/STAGE_*.md
  • API Documentation: docs/api/API_*.md, docs/api/*_ENDPOINTS*.md
  • Implementation Reports: docs/reports/*_IMPLEMENTATION*.md, docs/reports/*_SUMMARY.md
  • Deployment: docs/deployment/DEPLOYMENT_*.md, docs/deployment/RAILWAY_*.md
  • Quick References: docs/quick-reference/*_QUICK_*.md, docs/quick-reference/*_REFERENCE.md, docs/quick-reference/STEPS_*.md
  • Backend Features: docs/backend/RLHF_*.md, docs/backend/MEMORY_*.md, docs/backend/SECURITY_*.md
  • Development Guides: docs/development-guides/CODING_*.md, docs/development-guides/*_GUIDE.md, docs/guides/*_INSTRUCTIONS.md
  • Planning: docs/planning/PRD_*.md, docs/planning/BACKLOG*.md

Frontend Documentation → /Users/tobymorning/Desktop/core/AINative-website/docs/

  • Frontend Features: AINative-website/docs/features/
  • Frontend Testing: AINative-website/docs/testing/
  • Frontend Implementation: AINative-website/docs/implementation/
  • Frontend Issues: AINative-website/docs/issues/
  • Frontend Deployment: AINative-website/docs/deployment/
  • Frontend Reports: AINative-website/docs/reports/

Scripts → /Users/tobymorning/Desktop/core/scripts/

  • ALL test scripts: scripts/test_*.sh
  • ALL migration scripts: scripts/*_migration.sh
  • ALL monitoring scripts: scripts/monitor_*.sh
  • ALL utility scripts: scripts/*.sh

ENFORCEMENT WORKFLOW

Before creating ANY .md file or .sh script, you MUST:

  1. ✅ Check if you're creating it in a root directory
  2. ✅ If yes, STOP and use the appropriate docs/ or scripts/ subfolder
  3. ✅ Choose the correct category based on filename patterns above
  4. ✅ Create in the correct location FIRST TIME, not in root then move later

VIOLATION CONSEQUENCES

Creating documentation in root directories causes:

  • Project clutter and disorganization
  • Wasted time reorganizing files
  • Inconsistent documentation structure
  • Developer frustration
  • Loss of findability for important docs

THIS IS A ZERO-TOLERANCE RULE. ALWAYS use docs/ or scripts/ subfolders.

Reference Files

See references/directory-mapping.md for complete mapping table of filename patterns to required directory locations.