pdd-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PDD setup

PDD 设置

Add one short PDD block to the file that this repo's agents read, and keep
.pdd/
out of Git. This skill installs nothing: if you can read it, the PDD skills are already installed. The
pdd setup
command checks for a ready agent, does the same in the current folder, installs missing skills and updates eligible marked copies, then previews MCP changes for approval.
The bundled skills also include pdd-product, pdd-graph and pdd-setup. Bundled workflow names also include
product
.
  1. Pick the file:
    CLAUDE.md
    if it exists, else
    AGENTS.md
    . If neither exists, create
    AGENTS.md
    . Use the repo root.
  2. Write this block exactly. Leave out the RUNBOOK.md line if the pdd-prompting skill has no RUNBOOK.md.
  3. If the file already has a
    <!-- pdd:start -->
    …
    <!-- pdd:end -->
    block, replace only that block. Otherwise add the block at the end, after one empty line. Keep all other text.
  4. If the block is already the same, change nothing. If only one marker is there, stop and ask the person.
  5. In a Git repo, add the line
    .pdd/
    at the end of the root
    .gitignore
    if no line there is
    .pdd
    ,
    .pdd/
    ,
    /.pdd
    or
    /.pdd/
    (no space at the start). Create the file if needed. Keep all other bytes. If the last such line starts with
    !
    , or there is no such line but a line starts with
    !.pdd
    or
    !/.pdd
    (for example
    !.pdd/config.json
    ), change nothing and tell the person.
    pdd test
    keeps its local cache in
    .pdd/
    .
markdown
<!-- pdd:start -->
在当前仓库的 Agent 所读取的文件中添加一个简短的 PDD 配置块,并确保
.pdd/
不进入 Git。此 skill 不会安装任何内容:如果你能读到这些内容,说明 PDD skills 已经安装。
pdd setup
命令会检查是否已有准备就绪的 Agent,在当前目录执行相同操作,安装缺失的 skills,并更新符合条件的标记副本,然后预览 MCP 变更以供批准。
捆绑的 skills 还包括 pdd-product、pdd-graph 和 pdd-setup。捆绑的 workflow 名称还包括
product
。
  1. 选择文件:如果存在
    CLAUDE.md
    ,则使用它;否则使用
    AGENTS.md
    。如果两者都不存在,则创建
    AGENTS.md
    。使用仓库根目录。
  2. 原样写入以下配置块。如果 pdd-prompting skill 中没有 RUNBOOK.md,则省略 RUNBOOK.md 那一行。
  3. 如果文件中已经存在
    <!-- pdd:start -->
    …
    <!-- pdd:end -->
    配置块,则仅替换该配置块。否则,在文件末尾添加该配置块,并在此前保留一个空行。保留所有其他文本。
  4. 如果配置块已经相同,则不做任何更改。如果只存在其中一个标记,则停止操作并询问用户。
  5. 在 Git 仓库中,如果根目录
    .gitignore
    的末尾没有
    .pdd
    、
    .pdd/
    、
    /.pdd
    或
    /.pdd/
    这一行,则将
    .pdd/
    添加到末尾。必要时创建该文件。保留所有其他字节。如果最后一个匹配的行以
    !
    开头,或者不存在匹配行,但有一行以
    !.pdd
    或
    !/.pdd
    开头(例如
    !.pdd/config.json
    ),则不做任何更改并告知用户。
    pdd test
    会将本地缓存保存在
    .pdd/
    中。
markdown
<!-- pdd:start -->

PDD

PDD

This project uses PDD. Change the prompt that owns a file before the file. New code starts with its prompt. Files that no prompt owns change directly, with a test when behavior changes. Skills: pdd-prompting (the Prompting guide), pdd-feature, pdd-bug, pdd-small-change, pdd-product, pdd-setup and pdd-graph. Call one with
$pdd-feature
in Codex or
/pdd-feature
in Claude Code, or just ask for it by name. Full run with PRs:
pdd workflow run NAME ISSUE
(NAME: feature, bug, small-change, product or your own workflow). Before you write prompts or tests, read RUNBOOK.md in the pdd-prompting skill.
<!-- pdd:end -->

Never paste the guide or a workflow into the file. Show the person the diff.
This project uses PDD. Change the prompt that owns a file before the file. New code starts with its prompt. Files that no prompt owns change directly, with a test when behavior changes. Skills: pdd-prompting (the Prompting guide), pdd-feature, pdd-bug, pdd-small-change, pdd-product, pdd-setup and pdd-graph. Call one with
$pdd-feature
in Codex or
/pdd-feature
in Claude Code, or just ask for it by name. Full run with PRs:
pdd workflow run NAME ISSUE
(NAME: feature, bug, small-change, product or your own workflow). Before you write prompts or tests, read RUNBOOK.md in the pdd-prompting skill.
<!-- pdd:end -->

绝不要将 guide 或 workflow 粘贴到文件中。向用户展示 diff。