Terry-Mao · Terry-Mao · Jun 8, 2026 · Jun 8, 2026
@@ -94,8 +94,7 @@ def test_installs_regular_skill_and_github_workflow_directories(self) -> None:
             self.assertTrue((target / ".github/agents/product-wiki-query.md").is_file())
             self.assertTrue((target / ".github/scripts/validate_spec_output.py").is_file())
             self.assertFalse((target / ".github/tests").exists())
-            self.assertTrue((target / ".github/aicodingflow-tests/test_validate_spec_output.py").is_file())
-            self.assertFalse((target / ".github/aicodingflow-tests/test_install_script.py").exists())
+            self.assertFalse((target / ".github/aicodingflow-tests").exists())
             self.assertTrue((target / ".github/workflows/create-spec-from-issue.yml").is_file())
 
     def test_does_not_install_aicodingflow_repository_ci_workflow(self) -> None:

@@ -30,7 +30,7 @@ cd AICodingFlow
 ./install.sh --target /path/to/target-repo --dry-run
 ```
 
-安装脚本依赖 `bash`、`git`、`rsync`；使用一行安装命令时还需要 `curl`。它会同步 `.agents/skills/`、`.github/scripts/`、`.github/aicodingflow-tests/` 和受管 workflow，不会同步 AICodingFlow 仓库自用的 `.github/tests/` 与 `.github/workflows/ci.yml`。
+安装脚本依赖 `bash`、`git`、`rsync`；使用一行安装命令时还需要 `curl`。它会同步 `.agents/skills/`、`.agents/contracts/`、`.github/agents/`、`.github/scripts/` 和受管 workflow，不会同步 AICodingFlow 上游测试目录 `.github/aicodingflow-tests/`、仓库自用 `.github/tests/` 与 `.github/workflows/ci.yml`。
 
 安装后，在目标仓库配置：
 
@@ -99,7 +99,7 @@ issue -> triage/spec -> implement -> pr -> review -> comments -> merge
 .github/agents/                  # GitHub Copilot custom agents
 .github/workflows/               # GitHub Actions workflow
 .github/scripts/                 # workflow 使用的 Python helper
-.github/aicodingflow-tests/      # 随安装脚本交付的 workflow/script unittest 和 fixtures
+.github/aicodingflow-tests/      # AICodingFlow 上游 workflow/script unittest 和 fixtures，不随默认安装同步
 .github/tests/                   # AICodingFlow 本仓库自用 unittest
 .github/issue-triage/            # issue triage 配置
 docs/                            # 详细文档

@@ -21,24 +21,23 @@ skills。
 安装会同步以下 AICodingFlow 管理的目录到目标项目：
 
 - `.agents/skills/`
+- `.agents/contracts/`
 - `.github/agents/`
 - `.github/scripts/`
-- `.github/aicodingflow-tests/`
 - `.github/workflows/`
 
 普通 skills 可以复制或更新。仓库本地 companion skills，也就是
 `.agents/skills/*-repo/SKILL.md`，不会由安装脚本安装到目标项目；目标项目已有的 companion
 skills 会保留。此类 companion guidance 应由维护者或对应 `update-*` self-improvement
 流程在有证据时创建和更新。
 
-`.github/agents`、`.github/scripts`、`.github/aicodingflow-tests` 和 `.github/workflows` 会按 AICodingFlow
+`.github/agents`、`.github/scripts` 和 `.github/workflows` 会按 AICodingFlow
 源目录同步。目标项目 `.github` 下不属于这些同步目录的文件不会被删除，例如目标项目自己的
-Dependabot 配置、`.github/tests` 或其他 GitHub 设置文件。
+Dependabot 配置、`.github/tests`、`.github/aicodingflow-tests` 或其他 GitHub 设置文件。
 
-`.github/aicodingflow-tests` 是 AICodingFlow 上游托管的 workflow/script 测试目录，未来安装
-或同步可能覆盖其中内容。目标项目自己的测试应放在项目原有测试结构中；如果测试属于
-`.github` 相关逻辑，优先使用 `.github/tests/`，不要直接修改
-`.github/aicodingflow-tests/`。
+`.github/aicodingflow-tests` 是 AICodingFlow 上游托管的 workflow/script 测试目录，
+默认不会安装到目标项目。目标项目自己的测试应放在项目原有测试结构中；如果测试属于
+`.github` 相关逻辑，优先使用 `.github/tests/`。
 
 AICodingFlow 源仓库中的 `.github/workflows/ci.yml` 是参考最小 CI，不会由安装脚本同步到
 目标项目。目标项目应保留自己的 CI 编排，并在 CI 成功路径中 dispatch 已安装的

@@ -24,10 +24,10 @@ sources:
 
 ## 同步边界
 
-- 同步范围包括 `.agents/skills/`、`.agents/contracts/`、`.github/agents/`、`.github/scripts/`、`.github/aicodingflow-tests/` 和 `.github/workflows/`。
+- 同步范围包括 `.agents/skills/`、`.agents/contracts/`、`.github/agents/`、`.github/scripts/` 和 `.github/workflows/`。
 - `.agents/skills/*-repo/SKILL.md` 不由安装脚本安装；目标项目已有 repo-local companion skills 会保留。
 - 目标项目 `.github` 下不属于同步目录的文件不会被删除。
-- `.github/aicodingflow-tests/` 是上游托管测试目录，目标项目自己的 `.github` 相关测试应优先放在 `.github/tests/`。
+- `.github/aicodingflow-tests/` 是上游托管测试目录，默认不会安装到目标项目；目标项目自己的 `.github` 相关测试应优先放在 `.github/tests/`。
 - AICodingFlow 源仓库中的 `.github/workflows/ci.yml` 是参考最小 CI，不会同步到目标项目；目标项目应保留自己的 CI 编排，并在 CI 成功路径中 dispatch 已安装的 `review-pr.yml`。
 - 安装脚本不初始化 issue triage 配置；首次接入时可后续手动运行 `$bootstrap-issue-config`。
 

@@ -79,7 +79,7 @@
 
 - 新增 [Agent 目录布局摘要](summaries/agent-directory-layout.md) 与 [Agent 目录布局](concepts/agent-directory-layout.md)，记录 `.agents/` 共享入口、Claude/Codex/Cursor 本地入口和 Windows symlink 规则。
 - 更新 [index.md](index.md)，链接新增 summary 与 concept。
-- 校准 [项目安装脚本摘要](summaries/project-installer.md) 与 [项目安装脚本](concepts/project-installer.md)：安装同步目录包含 `.github/aicodingflow-tests/`，目标项目自有 `.github` 测试应优先放在 `.github/tests/`。
+- 校准 [项目安装脚本摘要](summaries/project-installer.md) 与 [项目安装脚本](concepts/project-installer.md)：默认安装不再同步 `.github/aicodingflow-tests/`；该目录保留为 AICodingFlow 上游测试资产，目标项目自有 `.github` 测试应优先放在 `.github/tests/`。
 
 ## 待确认 / 开放问题
 

@@ -26,11 +26,11 @@ AICodingFlow 提供仓库级安装脚本 `install.sh`，用于把 workflow autom
 
 ## 同步范围
 
-- 安装同步 `.agents/skills/`、`.github/agents/`、`.github/scripts/`、`.github/aicodingflow-tests/` 和 `.github/workflows/`。
+- 安装同步 `.agents/skills/`、`.agents/contracts/`、`.github/agents/`、`.github/scripts/` 和 `.github/workflows/`。
 - 普通 skills 可以复制或更新。
 - `.agents/skills/*-repo/SKILL.md` 这类仓库本地 companion skills 不会安装到目标项目；目标项目已有 companion skills 会保留。
 - 目标项目 `.github` 下不属于同步目录的文件不会被删除。
-- `.github/aicodingflow-tests/` 是 AICodingFlow 上游托管的 workflow/script 测试目录，目标项目自己的 `.github` 相关测试应优先放在 `.github/tests/`。
+- `.github/aicodingflow-tests/` 是 AICodingFlow 上游托管的 workflow/script 测试目录，默认不会安装到目标项目；目标项目自己的 `.github` 相关测试应优先放在 `.github/tests/`。
 - AICodingFlow 源仓库中的 `.github/workflows/ci.yml` 是参考最小 CI，不会同步到目标项目；目标项目应保留自己的 CI 编排，并在 CI 成功路径中 dispatch 已安装的 `review-pr.yml`。
 - AICodingFlow 源仓库自己的 `test_install_script.py` 不会安装到目标项目。
 

@@ -122,7 +122,7 @@ sync_skills() {
 sync_github_dirs() {
   local dirname src dest
 
-  for dirname in agents scripts aicodingflow-tests workflows; do
+  for dirname in agents scripts workflows; do
     src="$script_dir/.github/$dirname"
     [ -d "$src" ] || continue
     dest="$target_dir/.github/$dirname"