用于初始化项目或校验并生成 SDD 文档模板,确保规范齐全且为最新版本。
复制安装指令,让 AI 自动完成配置 · 推荐新手
请帮我安装 askskill 上的 "init-docs" 技能: 1. 下载 https://raw.githubusercontent.com/microsoft/devsquad-copilot/main/.github/plugins/devsquad/skills/init-docs/SKILL.md 2. 保存为 ~/.claude/skills/init-docs/SKILL.md 3. 装好后重载技能,告诉我可以用了
请为这个新项目初始化 SDD Framework 文档模板,生成 feature spec、migration spec、envisioning 和 ADR 模板,并说明每个文件用途。
生成完整的文档模板清单、基础内容结构,以及各模板的用途说明。
请检查当前仓库中的 SDD 文档模板是否齐全且为最新版本,指出缺失项、过期项,并给出需要更新的内容。
输出模板检查结果,列出缺失或过期的文档,并给出更新建议或补全内容。
项目里只有部分需求文档,请补齐缺少的 SDD 模板骨架,保持命名统一,并给出建议的目录结构。
补齐缺失模板的标准骨架,统一命名方式,并提供清晰的文档目录建议。
Manage 4 SDD Framework documentation templates.
| File | Purpose |
|---|---|
docs/features/TEMPLATE.md | Feature specification template |
docs/migrations/TEMPLATE.md | Migration specification template |
docs/envisioning/TEMPLATE.md | Envisioning document template |
docs/architecture/decisions/ADR-TEMPLATE.md | Architecture Decision Record template |
NEVER create, copy, or recreate files under
.github/plugins/. The plugin folder is managed externally. Ifsdd-init.shcannot be located via the discovery snippet below, inform the user to install/update the plugin.
The plugin can be installed in several locations (workspace, runtime env vars, ~/.vscode/agent-plugins/..., ~/.copilot/agent-plugins/...). Use the locate-sdd-init.sh helper to resolve the absolute path of sdd-init.sh once, then reuse it in every subsequent command. The discovery snippet:
for h in \
.github/plugins/devsquad/hooks/locate-sdd-init.sh \
"${COPILOT_PLUGIN_ROOT:-}/hooks/locate-sdd-init.sh" \
"${CLAUDE_PLUGIN_ROOT:-}/hooks/locate-sdd-init.sh" \
"$HOME/.vscode/agent-plugins/github.com/microsoft/devsquad-copilot/.github/plugins/devsquad/hooks/locate-sdd-init.sh" \
"$HOME/.copilot/agent-plugins/github.com/microsoft/devsquad-copilot/.github/plugins/devsquad/hooks/locate-sdd-init.sh" \
"$HOME/.copilot/installed-plugins/devsquad-copilot/devsquad/hooks/locate-sdd-init.sh"; do
if [ -n "$h" ] && [ -f "$h" ]; then
SDD_INIT="$("$h" 2>/dev/null || true)"
[ -n "$SDD_INIT" ] && [ -f "$SDD_INIT" ] && { echo "FOUND: $SDD_INIT"; exit 0; }
fi
done
echo "MISSING"
exit 1
Capture the absolute path printed after FOUND: and substitute it for <SDD_INIT> in every command below. Bash variables do not persist across tool calls, so use the literal path string.
<SDD_INIT> verify
Parse the JSON output. Each entry in docs has file, status (up-to-date, outdated, missing), and optionally summary.
To create or update specific files:
<SDD_INIT> create <target-path>
For bulk operations:
# Create only missing files
<SDD_INIT> create-missing
# Create missing + overwrite outdated
<SDD_INIT> update-all
To show a diff for an outdated file:
<SDD_INIT> diff <target-path>
帮助你创建、切换并检查代码分支,确保实现前遵循正确分支策略。
帮助开源项目优化增长策略、文档转化与贡献者获取流程。