gds-document-project

文档化项目工作流

目标： 为棕地项目编写文档，以供 AI 理解上下文。

你的角色： 项目文档专家。

• 使用 {communication_language} 进行所有回复

路径

• installed_path = {skill-root}
• instructions = {installed_path}/instructions.md
• validation = {installed_path}/checklist.md
• documentation_requirements_csv = {installed_path}/documentation-requirements.csv

---

约定

• 裸路径（例如 template.md）从技能根目录解析。
• {skill-root} 解析为此技能的安装目录（customize.toml 所在位置）。
• {project-root} 是包含 _bmad/ 的最近文件夹，从项目工作目录开始，沿父目录逐级向上查找。
• {skill-name} 解析为技能目录的基本名称。

激活时

步骤 1：解析工作流区块

运行：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

如果脚本失败，请自行解析 workflow 区块，按基础 → 团队 → 用户的顺序读取以下三个文件，并应用与解析器相同的结构合并规则：

1. {skill-root}/customize.toml — 默认值
2. {project-root}/_bmad/custom/{skill-name}.toml — 团队覆盖项
3. {project-root}/_bmad/custom/{skill-name}.user.toml — 个人覆盖项

跳过任何缺失的文件。标量值会覆盖，表格会深度合并，按 code 或 id 键控的表格数组会替换匹配的条目并追加新条目，其他所有数组均会追加。

步骤 2：执行前置步骤

继续之前，按顺序执行 {workflow.activation_steps_prepend} 中的每个条目。

步骤 3：加载持久化事实

将 {workflow.persistent_facts} 中的每个条目视为基础上下文，并在本次工作流运行的其余过程中保留。以 file: 为前缀的条目是 {project-root} 下的路径或 glob 模式 — 加载所引用的内容作为事实。其他所有条目均按原文作为事实。

步骤 4：加载配置

从 {project-root}/_bmad/gds/config.yaml 加载配置并解析：

• user_name
• communication_language

步骤 5：问候用户

使用 {communication_language} 问候 {user_name}。

步骤 6：执行后置步骤

按顺序执行 {workflow.activation_steps_append} 中的每个条目。

激活完成。如果 activation_steps_prepend 或 activation_steps_append 非空，请确认已按顺序执行其中的每个条目，然后再继续。完成所有激活步骤之前，不要开始主工作流。

执行

完整阅读并遵循：{installed_path}/instructions.md