openone-workflow-kit 0.1.0

package/docs/maintainer-handoff.md

@@ -0,0 +1,150 @@
+# 维护者交接
+
+本文面向 starter kit 的发布和支持维护者。内容必须保持通用，不得包含私有公司、客户、仓库、事故、URL、日志、SQL 或生产配置细节。
+
+## 当前交付状态
+
+在 package 根目录执行以下命令通过后，本 starter kit 可本地发布：
+
+```bash
+npm run check
+npm run build:release
+```
+
+构建会生成：
+
+- `dist/openone-workflow-kit-<version>.tgz`
+- `dist/RELEASE_MANIFEST.md`
+
+manifest 会记录包名、版本、license、归档大小、SHA-256、安装 smoke 状态和人工发布边界。
+
+## 维护者可以分享什么
+
+只能分享脱敏后的 starter kit 包，或只包含本 starter kit 的仓库：
+
+- `README.md`
+- `INIT.md`
+- `LICENSE`
+- `NOTICE`
+- `install.sh`
+- `bin/`
+- `scripts/`
+- `workflow/`
+- `templates/`
+- `examples/`
+- `docs/`
+- `test/`
+
+不要把来源团队的工作流文档、产品文档、需求目录、业务仓库、客户资料、日志、SQL、截图或内部 runbook 当成示例分享。
+
+## 人工发布边界
+
+agent 可以在本地准备、验证和打包 starter kit；远程发布动作需要维护者明确授权。
+
+需要维护者明确授权的动作：
+
+- 创建远程仓库；
+- 添加或修改 remote URL；
+- push commits；
+- 创建或 push tags；
+- 发布到 npm 或其他 package registry；
+- 上传归档到公共站点；
+- 在私有工作区运行远程 Git 刷新命令。
+
+发布命令清单见 `docs/manual-publish.md`，维护者应手动运行。
+
+## 接收方验收清单
+
+建议个人开发者先在临时工作区或一次性分支中运行初始化器。
+
+接收方应确认：
+
+- 已生成 `workflow/team-profile.yaml`。
+- 必要资料缺失时生成了 `workflow/INITIALIZATION_QUESTIONS.md`。
+- `workflow/core/` 存在，并包含命令、模板和能力说明。
+- `workflow/adapters/` 存在。
+- 选中的工具入口已生成，例如 `AGENTS.md`、`CLAUDE.md`、`.cursor/rules/`、`.github/copilot-instructions.md`、`.codebuddy/`、`.kiro/` 或 `.trae/`。
+- 使用 `trea` 时已归一为 `trae`。
+- 除非显式传入 `--force`，已有文件没有被覆盖。
+- 初始化期间没有远程 Git、push、构建、部署、数据库写入或生产配置写入。
+
+推荐 smoke 命令：
+
+```bash
+openone-workflow-init --target . --tools codex,claude,cursor,codebuddy,trea --yes
+```
+
+如果从本地 tarball 安装：
+
+```bash
+./node_modules/.bin/openone-workflow-init --target . --tools codex,claude,cursor,codebuddy,trea --yes
+```
+
+## 支持模型
+
+按层定位问题：
+
+- `workflow/core`: 阶段、硬闸门、模板和工具无关规则。
+- `workflow/team-profile.yaml`: 接收团队的本地配置和缺失资料问题。
+- `workflow/adapters`: 工具特定薄入口。
+- `bin/init-workspace.cjs`: 本地初始化逻辑。
+- `bin/check-sanitized.cjs`: 发布安全检查。
+
+团队反馈问题时，优先索要：
+
+- 执行的初始化命令；
+- Node.js 版本；
+- 选择的工具列表；
+- 已移除敏感内容的 `workflow/team-profile.yaml`；
+- 如存在，提供 `workflow/INITIALIZATION_QUESTIONS.md`；
+- 是否生成了 `.agent-workflow-new` 文件；
+- 精确错误输出。
+
+除非已经建立单独的安全支持渠道，不要要求团队发送私有源码、客户数据、凭证、日志、SQL 或生产配置。
+
+## 工具能力策略
+
+workflow core 必须保持工具无关。工具特定行为只能放在 adapters。
+
+能力等级：
+
+- L0：仅文档规则。
+- L1：prompt 或命令模板。
+- L2：当前工具内的自动规则触发。
+- L3：当前工具支持的 hooks 或本地自动化。
+- L4：当前工具支持的 subagents 或专项技能。
+
+不要承诺不同工具体验完全一致。应承诺同一套 workflow core，并按工具能力增强或降级。
+
+## 发布更新流程
+
+每次发布：
+
+1. 只修改通用 starter kit 文件。
+2. 私有示例留在本仓库之外。
+3. 运行 `npm run check`。
+4. 运行 `npm run build:release`。
+5. 检查 `dist/RELEASE_MANIFEST.md`。
+6. 检查 tarball 文件列表。
+7. 在临时目标工作区用 tarball 做安装 smoke test。
+8. 使用 starter kit 外部的私有 denylist 运行 `bin/check-sanitized.cjs --extra-banned <private-denylist-file>`。
+9. 由维护者手动发布到目标渠道。
+
+## 版本建议
+
+遵循 semantic versioning：
+
+- Patch：文档澄清、脱敏检查增强、adapter 文案修复、smoke test 修复。
+- Minor：新增 adapter、新增可选模板、新增非破坏性初始化参数或新 capability。
+- Major：改变生成文件布局、改变命令名、改变硬闸门语义或移除支持工具。
+
+## 明确不做
+
+本 starter kit 不会：
+
+- 托管或同步团队文档；
+- 替代代码实现闸门的人工确认；
+- 绕过本地工具限制；
+- 从一个 agent 工具调用另一个工具的私有能力；
+- 保证所有工具具有同等自动化水平；
+- 创建分支、push 代码、发布包、部署服务或写数据库。

package/docs/manual-publish.md

@@ -0,0 +1,119 @@
+# 手动发布指南
+
+本指南用于维护 OpenOne Workflow Kit 自身。agent 可以准备本地验证和发布说明；远程仓库创建、push、tag push 或 package 发布需要维护者明确授权。
+
+## v0.1.0 本地准入
+
+先运行：
+
+```bash
+npm run check
+npm run build:release
+```
+
+`build:release` 会拒绝存在已修改或未跟踪文件的工作树；生成的 `dist/RELEASE_MANIFEST.md` 必须记录当前 `source_commit`、`source_tree` 与 `source_dirty: false`。任何源码变更都要先形成新的 reviewed commit，再重新构建 tarball。
+
+可分享的本地归档位于：
+
+```text
+dist/openone-workflow-kit-<version>.tgz
+```
+
+校验信息见：
+
+```text
+dist/RELEASE_MANIFEST.md
+```
+
+再核对 npm 上没有已发布的同版本：
+
+```bash
+npm view openone-workflow-kit@0.1.0 version
+```
+
+首次发布前预期 Registry 返回 404/`E404`。只有精确的不存在结果才能解读为“尚未发布”；认证、网络或权限错误都必须先解决。
+
+## 方案 A：直接分享 tarball
+
+适合小范围试用。维护者手动发送 `dist/*.tgz`，接收方按 `docs/shareable-install.md` 安装。
+
+分享前必须：
+
+- 检查 `dist/RELEASE_MANIFEST.md`；
+- 用私有 denylist 扫描；
+- 人工检查 tarball 文件列表；
+- 确认没有私有资料、真实业务数据或凭证。
+
+## 发布 v0.1.0（授权后）
+
+以已验证的 `main` commit 为唯一基线。先 push 该 commit，并等待该 SHA 的 GitHub Actions 全绿：
+
+```bash
+git push origin main
+```
+
+发布前在同一个 clean checkout 中再次确认工作树、manifest 和本地 tarball SHA-1 都绑定同一 commit，并确认 npm 身份有效：
+
+```bash
+source_commit="$(sed -n 's/^- source_commit: //p' dist/RELEASE_MANIFEST.md)"
+source_tree="$(sed -n 's/^- source_tree: //p' dist/RELEASE_MANIFEST.md)"
+local_shasum="$(node -e "const fs=require('node:fs'),c=require('node:crypto');process.stdout.write(c.createHash('sha1').update(fs.readFileSync('dist/openone-workflow-kit-0.1.0.tgz')).digest('hex'))")"
+test -z "$(git status --porcelain=v1 --untracked-files=all)"
+test "$(git rev-parse HEAD)" = "$source_commit"
+test "$(git rev-parse 'HEAD^{tree}')" = "$source_tree"
+npm whoami
+```
+
+从这个 clean reviewed commit 的仓库目录发布，而不是直接发布 `dist/*.tgz`。directory publish 会让 npm 把当前 Git commit 写入公开的 `gitHead`；`build:release` 产生的 tarball 用于发布前复验和发布后内容哈希对照：
+
+```bash
+source_commit="$(sed -n 's/^- source_commit: //p' dist/RELEASE_MANIFEST.md)"
+local_shasum="$(node -e "const fs=require('node:fs'),c=require('node:crypto');process.stdout.write(c.createHash('sha1').update(fs.readFileSync('dist/openone-workflow-kit-0.1.0.tgz')).digest('hex'))")"
+test -z "$(git status --porcelain=v1 --untracked-files=all)"
+test "$(git rev-parse HEAD)" = "$source_commit"
+npm publish --access public
+registry_version="$(npm view openone-workflow-kit@0.1.0 version)"
+registry_git_head="$(npm view openone-workflow-kit@0.1.0 gitHead)"
+registry_shasum="$(npm view openone-workflow-kit@0.1.0 dist.shasum)"
+test "$registry_version" = "0.1.0"
+test "$registry_git_head" = "$source_commit"
+test "$registry_shasum" = "$local_shasum"
+```
+
+Registry 刚写入时允许做有上限的短暂重试；任何字段持续为空或不一致都属于发布阻塞，不得创建 Tag/Release 来掩盖。三项公开复验全部通过后，才从 manifest 中记录的同一 commit 创建新 Tag，并把已验证 tarball 与 manifest 一并上传 GitHub Release：
+
+```bash
+source_commit="$(sed -n 's/^- source_commit: //p' dist/RELEASE_MANIFEST.md)"
+test -z "$(git tag --list v0.1.0)"
+git tag -a v0.1.0 "$source_commit" -m "OpenOne Workflow Kit v0.1.0"
+git push origin v0.1.0
+gh release create v0.1.0 \
+  dist/openone-workflow-kit-0.1.0.tgz \
+  dist/RELEASE_MANIFEST.md \
+  --title "OpenOne Workflow Kit v0.1.0" \
+  --notes-file docs/releases/v0.1.0.md
+```
+
+不得移动或覆盖已存在的 Tag，也不得尝试覆盖 npm 中已存在的同版本。上述命令需要维护者明确授权后执行。
+
+发布后公开验收：
+
+```bash
+npm view openone-workflow-kit@latest version
+npm view openone-workflow-kit@0.1.0 gitHead
+npm view openone-workflow-kit@0.1.0 dist.shasum
+git ls-remote --tags origin refs/tags/v0.1.0
+gh release view v0.1.0 --json tagName,isDraft,isPrerelease,assets,url
+```
+
+## 远程发布前必须完成
+
+- 运行 `npm run check`。
+- 运行 `npm run build:release`。
+- 使用 `bin/check-sanitized.cjs --extra-banned <private-file>` 执行私有 denylist 扫描。
+- 检查 `dist/RELEASE_MANIFEST.md`。
+- 检查 tarball 内的每个文件。
+- 确认 directory publish 后 Registry 的 `gitHead` 等于 manifest `source_commit`，`dist.shasum` 等于本地已验证 tarball 的 SHA-1。
+- 确认 GitHub Release 同时包含 `openone-workflow-kit-0.1.0.tgz` 与 `RELEASE_MANIFEST.md` 两个证据资产。
+- 检查 README、license、示例和安装脚本。
+- push、tag push、npm publish 等远程写入必须有维护者明确授权。

package/docs/private-denylist.example.txt

@@ -0,0 +1,11 @@
+# 将本文件复制到 starter kit 目录之外，再替换下面的占位符。
+# 填写后的私有 denylist 不得提交到仓库。
+
+<company-name>
+<legal-entity-name>
+<internal-repository-prefix>
+<private-domain>
+<customer-name>
+<internal-system-name>
+<sensitive-business-term>
+<incident-code-name>

package/docs/publication-decisions.md

@@ -0,0 +1,36 @@
+# 发布决策
+
+OpenOne Workflow Kit 可以进行本地验证和本地打包。远程发布需要维护者明确授权。
+
+## 必要决策
+
+| 决策 | 选项 | 当前建议 |
+| --- | --- | --- |
+| License | Apache-2.0 / MIT / proprietary | Apache-2.0 |
+| 发布渠道 | GitHub / npm / 内部包仓 / tarball | GitHub + npm + tarball（v0.1.0 已授权目标） |
+| 贡献模型 | 关闭 / 仅 issue / 接收 PR / 需要 CLA | 接收 issue 和 PR 模板 |
+| 支持范围 | best-effort / paid / internal-only | best-effort |
+| 安全报告 | 私有邮箱 / GitHub private advisory / 内部渠道 | GitHub private advisory 或维护者私有渠道 |
+| 发布产物 | 只提交源码 / 允许提交 dist | 默认不提交 dist |
+
+## 首次外部试用建议
+
+- 使用 Apache-2.0。
+- 在 CI、tarball 和安装 smoke 全部通过后，从 clean reviewed commit 的仓库目录发布 npm `0.1.0`；公开核对 Registry `gitHead` / `dist.shasum` 后，再创建同 commit 的不可变 Git tag `v0.1.0` 和对应 GitHub Release。
+- GitHub Release 同时上传已验证 tgz 与 `RELEASE_MANIFEST.md`，让 source commit、source tree、npm 内容哈希和 Release 资产形成可复核证据链。
+- 接收 issue 和 PR，但要求脱敏。
+- 不承诺生产级支持。
+- 公开 README 中明确：初始化器只读本地资料，不执行远程 Git、分支、部署或数据库动作。
+
+## 公开发布前
+
+1. 运行 `npm run check`。
+2. 运行 `npm run build:release`。
+3. 使用 starter kit 外部的私有 denylist 扫描。
+4. 人工检查全部可分发文件和 `dist/RELEASE_MANIFEST.md`。
+5. 通过 `npm whoami` 确认发布身份，从 clean reviewed commit directory 发布，并核对 Registry `gitHead` 与 `dist.shasum`。
+6. 由维护者手动创建同 commit 的 release tag，并上传 tarball 与 manifest 资产。
+
+agent 不得执行 publish、push、tag 或远程仓库创建动作。
+
+手动命令示例维护在 `docs/manual-publish.md`。

package/docs/release-checklist.md

@@ -0,0 +1,72 @@
+# 外部分发检查清单
+
+发布到公共仓库、package registry、template repository 或文档站点前，使用本清单做最终检查。
+
+## 必须完成
+
+- `npm run check` 通过。
+- `npm run build:release` 通过。
+- `dist/RELEASE_MANIFEST.md` 的 `source_commit` 等于 reviewed commit、`source_tree` 等于该 commit 的 tree，且 `source_dirty: false`。
+- `npm pack --dry-run` 中 package/version/files/bin/repository/homepage/bugs 与 `package.json` 一致。
+- `dist/RELEASE_MANIFEST.md` 已人工检查。
+- tarball 文件列表已人工检查。
+- npm 认证已通过 `npm whoami` 验证，发布命令从 clean reviewed commit 的仓库目录执行，而不是直接发布 `dist/*.tgz`。
+- README、INIT、CONTRIBUTING、SECURITY、CODE_OF_CONDUCT、LICENSE、NOTICE 已检查。
+- 示例数据均为合成数据，不能追溯到真实客户、员工、项目、事故或生产系统。
+- 工具 adapter 只指向 workflow core，不削弱硬闸门。
+- 初始化器不会执行远程 Git、创建分支、push、构建 / 部署触发、数据库写入或生产配置写入。
+
+## 私有 denylist 扫描
+
+在 starter kit 外部创建私有 denylist 文件，然后运行：
+
+```bash
+node bin/check-sanitized.cjs --extra-banned /path/to/private-denylist.txt
+```
+
+私有 denylist 应包含公司名、内部仓库前缀、内部系统、客户名、私有域名、敏感业务术语和已知事故名称。不要把该文件提交到 starter kit。
+
+## 人工复核
+
+自动扫描不够。仍需人工检查：
+
+- commit message；
+- README 和 docs；
+- examples；
+- install 脚本；
+- workflow core；
+- adapter 输出；
+- package files 列表；
+- tarball 内容。
+
+重点关注：
+
+- 是否出现真实组织、真实仓库、真实 URL；
+- 是否包含业务数据、日志、SQL、截图或凭证；
+- 是否承诺“所有工具体验完全一致”；
+- 是否引导 agent 自动远程操作；
+- 是否把私有流程写成通用规则。
+
+## 发布决策
+
+以下事项明确前不要发布：
+
+- license；
+- 发布渠道；
+- 版本号；
+- 支持边界；
+- issue / PR 接收方式；
+- 私有安全报告渠道；
+- 是否允许提交 `dist/` 产物。
+
+## v0.1.0 远程真相源
+
+只有下列验证全部通过，才能宣布正式发布：
+
+- `npm view openone-workflow-kit@latest version` 返回 `0.1.0`。
+- `npm view openone-workflow-kit@0.1.0 gitHead` 等于 `RELEASE_MANIFEST.md` 的 `source_commit`。
+- `npm view openone-workflow-kit@0.1.0 dist.shasum` 等于本地已验证 tarball 的 SHA-1。
+- GitHub Actions 默认分支最新 `Check` workflow 全部成功。
+- `refs/tags/v0.1.0` 指向已验证的发布 commit，且没有移动历史 Tag。
+- GitHub Release `v0.1.0` 为 non-draft、non-prerelease，正文使用 `docs/releases/v0.1.0.md`，并包含已验证的 tgz 与 `RELEASE_MANIFEST.md` 两个资产。
+- 在一个新临时目录中从 npm 安装并生成 `workflow/team-profile.yaml`、`workflow/core/` 与 `AGENTS.md`。

package/docs/releases/v0.1.0.md

@@ -0,0 +1,70 @@
+# OpenOne Workflow Kit v0.1.0
+
+The first public release turns a solo developer's product delivery and commercialization work into one tool-neutral, evidence-backed workflow.
+
+## What is included
+
+- **Dual-track workflow:** a delivery track from requirements to release and a commercialization track from positioning to channel review.
+- **Definition-to-Done:** Completion Contracts, Definition Lint, Acceptance Oracles, and an autonomous delivery loop that stops only at verified completion or a precise blocker.
+- **Seven tool adapters:** Claude Code, Codex, Cursor, GitHub Copilot, CodeBuddy, Kiro, and Trae share one workflow core while retaining tool-specific capability levels.
+- **Local initialization:** scan a workspace, produce `workflow/team-profile.yaml`, copy the workflow core, and generate only the selected adapters.
+- **Release evidence:** sanitized-content checks, a package manifest with SHA-256, and an installed-tarball smoke test.
+
+## Security and privacy
+
+- The initializer does not upload local source material.
+- It does not run remote Git operations, publish packages, deploy services, write databases, or change production configuration.
+- Existing target files are preserved unless the maintainer explicitly chooses the documented force/upgrade path.
+- The package has no runtime dependencies. Release checks scan for private-key markers, credential assignments, and private-network URLs; an external private denylist can be supplied for repository-specific terms.
+
+These checks reduce accidental disclosure risk but do not replace a manual review of the package contents.
+
+## Install
+
+Requires Node.js 18 or newer.
+
+```bash
+npm install --save-dev openone-workflow-kit@0.1.0
+npx openone-workflow-init --target . --tools codex,claude,cursor --yes
+```
+
+For a one-off run without modifying `package.json`:
+
+```bash
+npx --yes --package openone-workflow-kit@0.1.0 openone-workflow-init --target . --tools codex,claude,cursor --yes
+```
+
+## Verify
+
+Confirm the published version and generated entry points:
+
+```bash
+npm view openone-workflow-kit@0.1.0 version
+node -e "for (const f of ['workflow/team-profile.yaml','workflow/core','AGENTS.md']) require('node:fs').accessSync(f); console.log('OpenOne ready')"
+```
+
+Expected output includes `0.1.0` and `OpenOne ready`.
+
+Maintainers can reproduce the release artifact locally:
+
+```bash
+npm run check
+npm run build:release
+npm pack --dry-run
+```
+
+The GitHub Release attaches `openone-workflow-kit-0.1.0.tgz` and `RELEASE_MANIFEST.md`. The manifest records the reviewed source commit/tree and the tarball SHA-256; the npm Registry metadata provides the matching Git `gitHead` and tarball `dist.shasum`:
+
+```bash
+npm view openone-workflow-kit@0.1.0 version
+npm view openone-workflow-kit@0.1.0 gitHead
+npm view openone-workflow-kit@0.1.0 dist.shasum
+```
+
+Those values are release evidence, not a substitute for the security and installation checks above.
+
+## Supported boundary
+
+The workflow core is shared, but adapter behavior can be enhanced or reduced according to each tool's capabilities. This release does not claim identical automation across tools or production certification for generated application code.
+
+See the [installation guide](https://github.com/bluecoast1379/openone-workflow-kit/blob/v0.1.0/docs/shareable-install.md), [Definition-to-Done guide](https://github.com/bluecoast1379/openone-workflow-kit/blob/v0.1.0/docs/definition-of-done.md), and [maintainer handoff](https://github.com/bluecoast1379/openone-workflow-kit/blob/v0.1.0/docs/maintainer-handoff.md) for details.

package/docs/shareable-install.md

@@ -0,0 +1,51 @@
+# 可分享安装方式
+
+本文面向拿到 OpenOne Workflow Kit 地址或发布归档的个人开发者。
+
+## 从本地 tarball 安装
+
+```bash
+cd /path/to/target-workspace
+npm install /path/to/openone-workflow-kit-<version>.tgz --save-dev
+npx openone-workflow-init --target . --tools codex,claude,cursor --yes
+```
+
+## 从 Git 地址安装
+
+```bash
+cd /path/to/target-workspace
+npm install "git+https://github.com/bluecoast1379/openone-workflow-kit.git#v0.1.0" --save-dev
+npx openone-workflow-init --target . --tools codex,claude,cursor --yes
+```
+
+如果使用 fork 或私有 mirror，请替换 URL。公开 Tag 之前请改用已验证的完整 commit SHA，不要把可变的 `main` 当作发布版本。初始化器只在本地工作区运行。
+
+## 从 package registry 安装
+
+先确认 Registry 中的确实存在对应版本：
+
+```bash
+cd /path/to/target-workspace
+npm view openone-workflow-kit@0.1.0 version
+npm install openone-workflow-kit@0.1.0 --save-dev
+npx openone-workflow-init --target . --tools codex,claude,cursor --yes
+```
+
+预期 `npm view` 输出 `0.1.0`。如果 Registry 尚未返回该版本，不应声称 npm 安装路径可用；请使用上方的已验证 tarball 或不可变 Git 引用。
+
+## 会生成什么
+
+- `workflow/team-profile.yaml`
+- `workflow/core/`
+- `workflow/adapters/`
+- `workflow/INSTALL_REPORT.md`
+- 必要资料缺失时生成 `workflow/INITIALIZATION_QUESTIONS.md`
+- 选中工具的薄入口，例如 `AGENTS.md`、`CLAUDE.md`、`.cursor/commands/`
+
+## 安全边界
+
+初始化器不会拉取远程代码、push 代码、触发构建、部署、写数据库或修改生产配置。它只读取本地文件，并把工作流文件写入目标工作区。生成后的个人工作流允许 agent 执行本地分支命名、创建、commit、tag 和本地 merge；远程 push、release、部署和生产配置写入需要用户明确授权。
+
+## 验收
+
+安装后按 [维护者交接](./maintainer-handoff.md) 的接收方清单检查。关键点是确认 `workflow/team-profile.yaml`、`workflow/core/` 和选中工具 adapter 已生成；缺失本地资料会记录在 `workflow/INITIALIZATION_QUESTIONS.md`。

package/docs/tool-install-recipes.md

@@ -0,0 +1,103 @@
+# 工具安装示例
+
+同一套 workflow core 会被多个工具共享。每个工具只获得自己的薄 adapter。
+
+## Codex
+
+```bash
+agent-workflow-init --target . --tools codex --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `.codex/prompts/`
+- `workflow/`
+
+## Claude Code
+
+```bash
+agent-workflow-init --target . --tools claude --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `CLAUDE.md`
+- `.claude/commands/`
+- `workflow/`
+
+## Cursor
+
+```bash
+agent-workflow-init --target . --tools cursor --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `.cursor/rules/agent-workflow-core.mdc`
+- `.cursor/commands/`
+- `workflow/`
+
+## GitHub Copilot
+
+```bash
+agent-workflow-init --target . --tools copilot --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `.github/copilot-instructions.md`
+- `workflow/`
+
+## CodeBuddy
+
+```bash
+agent-workflow-init --target . --tools codebuddy --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `.codebuddy/instructions.md`
+- `workflow/`
+
+## Kiro
+
+```bash
+agent-workflow-init --target . --tools kiro --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `.kiro/instructions.md`
+- `workflow/`
+
+## Trae
+
+```bash
+agent-workflow-init --target . --tools trae --yes
+```
+
+或使用别名：
+
+```bash
+agent-workflow-init --target . --tools trea --yes
+```
+
+生成文件：
+
+- `AGENTS.md`
+- `.trae/instructions.md`
+- `workflow/`
+
+## 多工具安装
+
+```bash
+agent-workflow-init --target . --tools codex,claude,cursor,copilot,codebuddy,kiro,trae --yes
+```
+
+不要期待每个工具提供完全相同的运行体验。core 是同一套，adapter 能力取决于当前工具。