菜单
在仓库根目录初始化项目规范文档骨架并生成最小 README 模板。用于用户要求创建 `docs/` 规范目录、搭建 `rules`/`knowledge`/`changes`/`archives` 工作区、初始化 spec 文档承载结构，或在已有 `docs/` 存在时按 `docs_v2`、`docs_v3` 等安全回退命名创建新文档骨架时。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend.
Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data via Chrome DevTools MCP.
Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.
Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.
Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.
Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project.
| name | spec-init |
| description | 在仓库根目录初始化项目规范文档骨架并生成最小 README 模板。用于用户要求创建 `docs/` 规范目录、搭建 `rules`/`knowledge`/`changes`/`archives` 工作区、初始化 spec 文档承载结构，或在已有 `docs/` 存在时按 `docs_v2`、`docs_v3` 等安全回退命名创建新文档骨架时。 |
在执行本 skill 时，同时遵守 ../../references/full-sdd-lifecycle.md 中 spec-init 阶段的协同规则。
skills/documentation-and-adrs/SKILL.md 的心智约束目录职责与长期文档边界skills/context-engineering/SKILL.md 控制初始化阶段只读取最少上下文spec-propose、spec-apply 等阶段动作在当前工作目录创建一套可持续演进的规范文档骨架。
按下面顺序执行，不要跳步：
docs/docs/ 已存在，则依次检查 docs_v2/、docs_v3/、docs_v4/README.md。docs/ 等价的规范体系，先说明差异，再决定是复用还是新建版本化目录。始终创建完整结构：
<root>/
├── rules/
│ └── README.md
├── knowledge/
│ └── README.md
├── changes/
│ ├── templates/
│ │ └── README.md
│ ├── log/
│ │ └── README.md
│ └── README.md
└── archives/
└── README.md
其中 <root> 是 docs/ 或冲突回退后的 docs_vN/。
为每个目录写简洁、稳定、可复用的说明文件。
使用以下模板内容。
rules/README.md# 总览
本目录用于沉淀仓库级代码约束、架构边界和质量要求，避免实现偏离项目设计。
## 文件概述
- 当前目录下的每个规则文件都应是默认生效的长期约束
## 执行原则
- 代码实现必须满足本目录规则，否则视为未完成交付
knowledge/README.md# 总览
本目录用于沉淀项目领域知识、背景上下文和术语说明，供实现时按需参考。
## 内容建议
- 业务概念
- 外部系统背景
- 数据模型背景
- 常见术语解释
changes/README.md# 总览
本目录用于管理活跃变更，包括模板、任务拆解和变更日志。
## 子目录说明
- `templates/`: 放置可复用模板
- `log/`: 记录需求、设计与实现过程中的关键变更
changes/templates/README.md# 总览
本目录用于存放可重复使用的文档模板，供后续规格、任务和记录文件复用。
## 内容建议
- 规格模板
- 任务拆解模板
- 记录模板
changes/log/README.md# 总览
本目录用于记录需求、设计、实现和验收过程中的关键变更，确保决策可追溯。
## 记录建议
- 需求调整
- 设计取舍
- 实现偏差
- 验收结论
archives/README.md# 总览
本目录用于归档已完成、已废弃或已替代的历史文档，避免干扰当前活跃工作区。
## 使用建议
- 仅归档不再活跃维护的内容
- 归档前应确保活跃目录已有最新版本
始终满足以下要求：
docs/docs_v2/、docs_v3/、docs_v4/ 顺序递增AGENTS.mdspec-*.md创建完成后至少检查以下内容：
rules/、knowledge/、changes/、archives/ 是否全部存在changes/templates/ 与 changes/log/ 是否存在README.md 是否存在向用户返回简洁结果，至少包含：