@colin4k1024/tsp 2.4.0 → 2.4.2

package/README.md

@@ -65,6 +65,8 @@ TSP 整合了多个社区开源框架的精华能力，而非从零构建：
 | **ECC** (Everything Claude Code) | 社区 | 125+ specialist skills、27 specialist agents、language rules packs、runtime hooks、安装工具链 |
 | **BMAD** | 方法来源（已吸收） | 单入口主链（`/team-help`）、Requirement Challenge、Design Review、Implementation Readiness、Story Slice、`artifact:persist` 落盘、Release→Closeout 收口 |
 | **Graphify** | 社区（`safishamsi/graphify`） | 可选知识图谱能力（brownfield 结构扫描、依赖路径分析、架构问答证据），以 runbook + 本地 skill 接入，不替换 workflow-engine |
+| **GitNexus** | 社区（`abhigyanpatwari/GitNexus`） | 受控可选代码智能能力（MCP 查询、impact、detect_changes、多仓图谱证据），以 runbook + thin skill 接入，不内置依赖 |
+| **Open Design** | 社区（`nexu-io/open-design`） | 受控可选设计工作台能力（本地优先原型、deck、dashboard、mobile flow、`DESIGN.md`、导出 artifact），以 runbook + thin skill 接入，不内置 daemon |
 | **GSD** (Getting Shit Done) | 社区 | Quality Gates 分类法（4 类 gate）、wave-execution、session-continuity、discuss-phase、quick-execution、context-engineering、workflow-forensics |
 | **gstack** | 社区 | brainstorming 苏格拉底式创意探索、cross-model-review 跨模型交叉审查、multi-perspective-review 多视角评审（CEO/Design/Eng/DevEx） |
 | **Superpowers** | 社区 | session-continuity 会话暂停/恢复、subagent-driven-development 子 agent 驱动开发、git-worktree-isolation 任务隔离 |
@@ -72,6 +74,32 @@ TSP 整合了多个社区开源框架的精华能力，而非从零构建：
 | **rtk** (Rust Token Killer) | 社区 | CLI 代理透明命令重写，60-90% token 节约，100+ 命令支持（git/gh/cargo/npm/docker/kubectl/aws） |
 | 社区贡献 | 多方 | UI/UX Pro Max 设计系统、vertical workflow examples、Santa Method 对抗验证、Ralph RFC Pipeline |
 
+### 外部设计能力接入
+
+TSP 当前支持把第三方设计能力作为外部扩展接入使用。设计工具负责高保真 artifact，TSP 负责团队协作、角色分工、handoff、quality gate 与发布收口。
+
+[Open Design](https://github.com/nexu-io/open-design) 是当前已纳入安装面导航的受控可选设计工作台：它提供本地优先 web/daemon、coding-agent CLI 调度、31 个设计 skills、设计系统库、sandbox preview 与 HTML/PDF/PPTX/ZIP/MP4 等导出链路。TSP 侧落点是 [skills/open-design/SKILL.md](skills/open-design/SKILL.md) 与 [docs/runbooks/open-design-integration.md](docs/runbooks/open-design-integration.md)，并通过 `design-prototyping` module 进入 `team` / `full` profile。其中 `full` profile 会自动执行 [scripts/install-open-design.js](scripts/install-open-design.js)，把 Open Design clone/update 到 `~/.tsp/open-design`，并在 `corepack` / `pnpm` 可用时安装依赖。TSP 不 vendoring Open Design 源码、daemon、skills、design-systems 或 SQLite 数据。
+
+[huashu-design](https://github.com/alchaincyf/huashu-design) 仍作为文档级协同能力保留：它偏向高保真设计产出，覆盖 HTML 原生交互原型、浏览器演讲幻灯片、时间轴动画、信息图与 5 维度设计评审。
+
+推荐的组合方式是：让 TSP 管任务链路，让外部设计工具管最终视觉和动效交付。典型场景包括：
+
+- `frontend-engineer` 先在 TSP 流程内收敛页面目标、状态边界和验收标准，再调用 Open Design 或 huashu-design 做高保真原型或动画样机。
+- `tech-lead` / `qa-engineer` 在评审阶段把 HTML demo、deck、dashboard、mobile flow 或动画作为 UI 证据补充到 review / release 资料里。
+- `product-manager` / `architect` 在方案讨论阶段借助设计方向顾问、设计评审与 deck 产出，加速多方案对比。
+
+上游安装方式：
+
+```bash
+npx skills add alchaincyf/huashu-design
+```
+
+当前仓库对 huashu-design 的接入是文档级集成，而不是内置分发：
+
+- TSP 不会把 huashu-design 自动打包进 `skills/`、install profile、npm 包或 overlay 清单。
+- 你需要单独从上游安装和更新该 skill，再在 TSP 任务流里按需调用。
+- 由于上游 README 明确写明企业/商用/工具链集成需先获得授权，本仓库目前只提供接入说明与致谢，不 vendoring 上游 `SKILL.md`、assets、scripts 或 references。
+
 ### 核心依赖
 
 | 依赖 | 用途 |
@@ -172,6 +200,59 @@ TSP 整合了多个社区开源框架的精华能力，而非从零构建：
 
 完整矩阵见 [docs/runbooks/command-and-capability-matrix.md](docs/runbooks/command-and-capability-matrix.md) 和 [docs/runbooks/runtime-capabilities-overview.md](docs/runbooks/runtime-capabilities-overview.md)。
 
+## 致谢 / Acknowledgements
+
+TSP 的公开能力是在多个社区项目、技能仓库和工程方法论的基础上吸收、裁剪和重组出来的。以下仓库是当前根 README 主叙事里直接引用或明确协同的社区 GitHub：
+
+| 仓库 | 在 TSP 中的关系 | 说明 |
+|------|------|------|
+| [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) | 上游能力来源 | ECC harness layer、specialist agents、skills、runtime hooks 与安装工具链的重要参考来源 |
+| [safishamsi/graphify](https://github.com/safishamsi/graphify) | 已吸收并本地化 | 为 brownfield 结构扫描、依赖路径分析与架构问答补充知识图谱能力 |
+| [abhigyanpatwari/GitNexus](https://github.com/abhigyanpatwari/GitNexus) | 受控可选接入 | 为 brownfield MCP 查询、impact、detect_changes 和多仓代码图谱证据提供外部能力；因许可证与 Node 20 要求，不内置依赖 |
+| [nexu-io/open-design](https://github.com/nexu-io/open-design) | 受控可选接入 | 为本地优先原型、deck、dashboard、mobile flow、`DESIGN.md` 与可导出视觉 artifact 提供外部设计工作台；不内置 daemon 或上游源码 |
+| [rtk-ai/rtk](https://github.com/rtk-ai/rtk) | 已集成运行时能力 | CLI 透明命令重写与 token 优化能力来源 |
+| [VoltAgent/awesome-design-md](https://github.com/VoltAgent/awesome-design-md) | 设计资产来源 | 为 `DESIGN.md` 品牌风格扩展提供参考品牌库 |
+| [alchaincyf/huashu-design](https://github.com/alchaincyf/huashu-design) | 外部协同能力 | 提供高保真原型、HTML slides、动画与设计评审能力；当前仅做文档级接入说明，不内置分发 |
+
+### 已吸收并落地的外部能力来源
+
+以下上游项目已经通过 intake / runbook / skill 适配进入当前仓库的公开能力面；对应的采用边界、落地状态与本地化结果见 [docs/runbooks/external-capability-intake.md](docs/runbooks/external-capability-intake.md)。
+
+| 分组 | 上游项目 | 当前在仓库中的落点 |
+|------|------|------|
+| 协作与行为技能 | [anthropics/skills](https://github.com/anthropics/skills), [Colin4k1024/andrej-karpathy-skills](https://github.com/Colin4k1024/andrej-karpathy-skills), [tanweai/pua](https://github.com/tanweai/pua), [obra/superpowers](https://github.com/obra/superpowers), [omkamal/pypict-claude-skill](https://github.com/omkamal/pypict-claude-skill), [testcontainers/testcontainers-java](https://github.com/testcontainers/testcontainers-java) | 浏览器 smoke、Karpathy 行为护栏、PUA 闭环、systematic debugging、pairwise-test-design、Testcontainers 集成测试 |
+| PR、发布与 API 治理 | [qodo-ai/pr-agent](https://github.com/qodo-ai/pr-agent), [reviewdog/reviewdog](https://github.com/reviewdog/reviewdog), [reviewdog/action-eslint](https://github.com/reviewdog/action-eslint), [semantic-release/release-notes-generator](https://github.com/semantic-release/release-notes-generator), [semantic-release/semantic-release](https://github.com/semantic-release/semantic-release), [OpenAPITools/openapi-diff](https://github.com/OpenAPITools/openapi-diff), [stoplightio/spectral](https://github.com/stoplightio/spectral) | AI PR review、reviewdog 门禁、release notes 自动化、API breaking change / lint runbooks |
+| 供应链、安全与 provenance | [actions/dependency-review-action](https://github.com/actions/dependency-review-action), [github/codeql-action](https://github.com/github/codeql-action), [aquasecurity/trivy-action](https://github.com/aquasecurity/trivy-action), [ossf/scorecard-action](https://github.com/ossf/scorecard-action), [anchore/sbom-action](https://github.com/anchore/sbom-action), [actions/attest-build-provenance](https://github.com/actions/attest-build-provenance), [sigstore/cosign-installer](https://github.com/sigstore/cosign-installer), [slsa-framework/slsa-verifier](https://github.com/slsa-framework/slsa-verifier), [sigstore/policy-controller](https://github.com/sigstore/policy-controller), [pact-foundation/pact-jvm](https://github.com/pact-foundation/pact-jvm), [slsa-framework/slsa-github-generator](https://github.com/slsa-framework/slsa-github-generator), [in-toto/attestation](https://github.com/in-toto/attestation), [in-toto/witness](https://github.com/in-toto/witness) | dependency review、CodeQL、Trivy、Scorecard、SBOM、attestation、签名、SLSA 验证、policy controller、contract testing 等发布前后治理 runbooks |
+| 平台治理与基础设施门禁 | [renovatebot/renovate](https://github.com/renovatebot/renovate), [gitleaks/gitleaks](https://github.com/gitleaks/gitleaks), [step-security/harden-runner](https://github.com/step-security/harden-runner), [rhysd/actionlint](https://github.com/rhysd/actionlint), [zizmorcore/zizmor](https://github.com/zizmorcore/zizmor), [open-policy-agent/conftest](https://github.com/open-policy-agent/conftest), [bridgecrewio/checkov](https://github.com/bridgecrewio/checkov), [yannh/kubeconform](https://github.com/yannh/kubeconform), [GitHubSecurityLab/actions-permissions](https://github.com/GitHubSecurityLab/actions-permissions), [kyverno/kyverno](https://github.com/kyverno/kyverno), [helm-unittest/helm-unittest](https://github.com/helm-unittest/helm-unittest) | 依赖升级、secret scanning、runner hardening、workflow lint / audit、policy-as-code、IaC 校验、Kubernetes schema / policy / chart 测试 |
+
+### 技能与工具参考来源
+
+以下项目主要出现在 `skills/`、参考资料或配套文档中，作为具体 skill、范式、工具链或示例来源，同样在此统一致谢：
+
+| 分组 | 上游项目 | 当前用途 |
+|------|------|------|
+| UI/UX 与设计智能 | [nextlevelbuilder/ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | `ui-ux-promax` 的上游来源与方法库 |
+| 测试与评估 | [google/googletest](https://github.com/google/googletest), [joaquinhuigomez/agent-eval](https://github.com/joaquinhuigomez/agent-eval) | C++ testing / GoogleTest 参考、agent evaluation 方法与任务评测参考 |
+| 仓库分析与记忆 | [haibindev/repo-scan](https://github.com/haibindev/repo-scan), [sreedhargs89/context-keeper](https://github.com/sreedhargs89/context-keeper) | repo-scan、ck / context keeper 相关能力来源 |
+| 多 agent 编排 | [humanplane](https://github.com/humanplane), [standardagents/dmux](https://github.com/standardagents/dmux) | RFC pipeline 分解思路、dmux 多 pane agent orchestration |
+| Agent 开发框架与媒体参考 | [cloudwego/eino](https://github.com/cloudwego/eino), [cloudwego/eino-ext](https://github.com/cloudwego/eino-ext), [video-db/videodb-cookbook](https://github.com/video-db/videodb-cookbook) | ADK framework adapters 的 EINO 参考、VideoDB cookbook 示例 |
+
+### 全仓 README 与文档 GitHub 引用补充清单
+
+以下仓库同样出现在本仓库其他 `README*.md`、skill 文档或参考资料中，主要用于示例、教程、生态说明或补充参考。它们被纳入致谢归档，但不等于 TSP 的核心依赖或正式内置能力：
+
+| 分组 | 仓库 | 主要出现位置 | 用途 |
+|------|------|------|------|
+| GoFrame 生态 | [gogf/gf](https://github.com/gogf/gf) | `skills/goframe-v2/examples/**/README*.MD` | GoFrame 框架本体及 contrib 模块引用 |
+| GoFrame 示例 | [gogf/examples](https://github.com/gogf/examples) | `skills/goframe-v2/examples/**/README*.MD` | 示例仓库、教学与 clone 指引 |
+| 依赖注入 | [samber/do](https://github.com/samber/do) | `skills/goframe-v2/examples/practices/injection/README*.MD` | DI 示例依赖 |
+| JWT | [golang-jwt/jwt](https://github.com/golang-jwt/jwt) | `skills/goframe-v2/examples/httpserver/jwt/README*.MD` | JWT 认证示例依赖 |
+| MongoDB | [mongodb/mongo-go-driver](https://github.com/mongodb/mongo-go-driver) | `skills/goframe-v2/examples/nosql/mongodb/README*.MD` | MongoDB 官方 Go 驱动参考 |
+| Redis | [redis/go-redis](https://github.com/redis/go-redis) | `skills/goframe-v2/examples/nosql/redis/README*.MD` | Redis Go 客户端参考 |
+| 服务治理 | [polarismesh/polaris](https://github.com/polarismesh/polaris) | `skills/goframe-v2/examples/config/polaris/README.MD` | Polaris 服务发现 / 配置生态参考 |
+
+如果后续有新的 README 引用了社区 GitHub 仓库，默认也应同步补入本节，保持主入口文档的致谢口径完整可追溯。
+
 ## BMAD 方法论（当前口径）
 
 当前仓库对 BMAD 的使用不是并行命令体系，而是吸收到 `/team-*` 主链中的执行方法。主链口径统一为：`/team-help -> challenge -> design -> readiness -> story-slice execute -> release -> closeout`。
@@ -190,12 +271,12 @@ TSP 整合了多个社区开源框架的精华能力，而非从零构建：
 - 文档生命周期字段用于明确责任与新鲜度：`doc_tier`、`owner`、`updated`、`last_verified`、`source_of_truth`。
 - 历史资料通过 `doc_tier: historical` 分层，避免与现行操作手册并列误用。
 
-## 可选知识图谱能力（Graphify）
+## 可选知识图谱能力（Graphify + GitNexus）
 
-- 定位：Graphify 作为可选能力用于 brownfield 结构认知，不替代 workflow-engine 或 `/team-*` 主链。
-- 入口：先执行 `npm run graphify:doctor` 做依赖检查，再按 [docs/runbooks/graphify-knowledge-graph-usage.md](docs/runbooks/graphify-knowledge-graph-usage.md) 执行 `build/query/path/explain`。
+- 定位：Graphify 作为轻量结构证据层，GitNexus 作为受控可选代码智能层；两者都不替代 workflow-engine 或 `/team-*` 主链。
+- 入口：Graphify 先执行 `npm run graphify:doctor`，GitNexus 先执行 `npm run gitnexus:doctor`；详细操作见 [graphify-knowledge-graph-usage.md](docs/runbooks/graphify-knowledge-graph-usage.md) 与 [gitnexus-code-intelligence-usage.md](docs/runbooks/gitnexus-code-intelligence-usage.md)。
 - 分发：通过安装模块 `knowledge-graph` 与组件 `capability:knowledge-graph` 提供；仅默认纳入 `research` 与 `full` profile。
-- 治理边界：不在本仓库执行 `graphify codex install` 或 `graphify claude install`，避免改写 AGENTS/hooks 契约。
+- 治理边界：不在本仓库执行 Graphify/GitNexus 的自动 setup 类命令；GitNexus 不进入 TSP 依赖，且索引时必须保护既有 AGENTS/CLAUDE 契约。
 
 ## 近期新增功能（v2.0.0 → v2.3.0）
 
@@ -249,6 +330,8 @@ node scripts/install-apply.js uninstall --target claude        # dry-run 默认
 node scripts/install-apply.js uninstall --target claude --apply
 ```
 
+`enterprise overlay` 是公开仓保留的私有扩展入口；公开 npm 包不内置公司专属 skills、rules 或 profile。
+
 ### BMAD Absorption v2（v2.1.12）
 
 - `/team-help` 继续收口为 `/team-*` 唯一公开入口，不新增 `/bmad-*` 并行命令面

package/bin/lib/post-install-bridge.js

@@ -219,8 +219,8 @@ async function provisionBridge(packageRoot, installRoot, crateDir, dependencies
   ui.warn(
     `No bundled prebuilt binary found for ${plat}-${arch}.\n` +
     `  The npm package may have been published without prebuilt binaries.\n` +
-    `  Try reinstalling: npx @colin4k1024/tsp-create@latest\n` +
-    `  Or use source mode: npx @colin4k1024/tsp-create --from-source`
+    `  Try reinstalling: npx @colin4k1024/tsp@latest\n` +
+    `  Or use source mode: npx @colin4k1024/tsp --from-source`
   );
   ui.warn('Self-evolution hooks will run in passthrough mode until the binary is provisioned.');
   return null;

package/bin/tsp-create.js

@@ -5,11 +5,11 @@
  * tsp-create — interactive npx installer for the Team Skills Platform.
  *
  * Usage:
- *   npx @colin4k1024/tsp-create                      # interactive wizard
- *   npx @colin4k1024/tsp-create --target claude --profile team
- *   npx @colin4k1024/tsp-create --from-source         # git clone mode
- *   npx @colin4k1024/tsp-create --dry-run
- *   npx @colin4k1024/tsp-create --help
+ *   npx @colin4k1024/tsp                             # interactive wizard
+ *   npx @colin4k1024/tsp --target claude --profile team
+ *   npx @colin4k1024/tsp --from-source                # git clone mode
+ *   npx @colin4k1024/tsp --dry-run
+ *   npx @colin4k1024/tsp --help
  */
 
 const ui = require('./lib/ui');
@@ -83,10 +83,10 @@ function showHelp(exitCode = 0) {
 ${ui.bold('tsp-create')} — Team Skills Platform interactive installer
 
 ${ui.bold('Usage:')}
-  npx @colin4k1024/tsp-create                       Interactive wizard
-  npx @colin4k1024/tsp-create --target claude --profile team
-  npx @colin4k1024/tsp-create --from-source          Clone from git
-  npx @colin4k1024/tsp-create --dry-run              Preview without writing
+  npx @colin4k1024/tsp                              Interactive wizard
+  npx @colin4k1024/tsp --target claude --profile team
+  npx @colin4k1024/tsp --from-source                 Clone from git
+  npx @colin4k1024/tsp --dry-run                     Preview without writing
 
 ${ui.bold('Options:')}
   --target <name>       Target platform (${targetIds})
@@ -150,7 +150,7 @@ async function main() {
       const profileIds = formatInlineList(listPublicInstallProfiles().map((profile) => profile.id));
       ui.warn('stdin is not a TTY — the interactive wizard cannot run.');
       ui.info('Use non-interactive flags instead:');
-      ui.info('  npx @colin4k1024/tsp-create --from-source --target claude --profile team');
+      ui.info('  npx @colin4k1024/tsp --from-source --target claude --profile team');
       ui.info(`Available targets:  ${targetIds}`);
       ui.info(`Available profiles: ${profileIds}`);
       process.exit(1);
@@ -190,7 +190,7 @@ async function main() {
     const profileIds = formatInlineList(listPublicInstallProfiles().map((profile) => profile.id));
     ui.warn('stdin is not a TTY — the interactive wizard cannot run.');
     ui.info('Use non-interactive flags instead:');
-    ui.info('  npx @colin4k1024/tsp-create --target claude --profile team');
+    ui.info('  npx @colin4k1024/tsp --target claude --profile team');
     ui.info('');
     ui.info(`Available targets:  ${targetIds}`);
     ui.info(`Available profiles: ${profileIds}`);

package/commands/team-help.md

@@ -34,8 +34,8 @@
 2. 默认以 `karpathy-guidelines` 的方式先暴露歧义、范围边界与更简单路径，不在入口阶段静默替用户补全高风险假设。
 3. 检查现有证据是否齐备：PRD、delivery-plan、arch-design、handoff、execute-log、test-plan、launch-acceptance、deployment-context、release-plan、closeout-summary，以及 `docs/memory/project-context.md`。
 4. 若任务边界清晰、影响面小、风险低，优先推荐 `/quick`；否则继续沿 `/team-*` 主链推进。
-5. 若是既有项目（brownfield）且现状上下文不足，优先建议执行 `/update-codemaps` 并启用 `doc-architecture`，把现有模块、集成点、关键数据流和历史包袱回落到 `delivery-plan.md` / `arch-design.md`。
+5. 若是既有项目（brownfield）且现状上下文不足，优先建议执行 `/update-codemaps` 并启用 `doc-architecture`，需要轻量结构证据时选择 Graphify，需要跨模块影响面或 MCP 证据时选择 GitNexus，再把现有模块、集成点、关键数据流和历史包袱回落到 `delivery-plan.md` / `arch-design.md`。
 6. 若需求规模较大或涉及多角色并行，实现前先要求把计划切成可独立验收、可独立 handoff 的 story-sized execution units，并确认 `artifact:persist` 已创建对应任务目录与关键 artifact，再进入 `/team-execute`。
 7. 若缺少 PRD 或需求边界，推荐 `/team-intake`；若缺少 challenge、design review 或 implementation-readiness，推荐 `/team-plan`；若 readiness proof 与 handoff 齐备，推荐 `/team-execute`；若已完成实现与自测，推荐 `/team-review`；若已获得放行，推荐 `/team-release`；若发布观察窗口结束，推荐 `/team-closeout`。
-8. 若是既有项目且上下文不足，提示先补齐 brownfield / doc-architecture 类上下文，再进入计划或执行。
+8. 若是既有项目且上下文不足，提示先补齐 brownfield / doc-architecture 类上下文；必要时用 Graphify 或 GitNexus 补图谱证据，再进入计划或执行。
 9. 输出结构化建议：推荐命令、原因、阻塞项、降级路径，并说明是否需要先运行 `npm run workflow:readiness`。

package/commands/team-plan.md

@@ -40,7 +40,7 @@
 2. 默认把 `karpathy-guidelines` 作为计划收口护栏：要求显式写出假设、更简单备选路径、当前不做项，以及为什么本轮范围已经足够。
 3. 按任务特征装配动态讨论分组，先讨论再收敛，避免未经质疑直接进入计划冻结。
 4. 若启用 `doc-architecture`，补齐 Service Catalog、Communication Matrix、NFR Summary，并明确其 artifact 回落位置。
-5. 若是既有项目（brownfield），先梳理现有模块边界、外部依赖、历史约束和缺失文档；必要时运行 `/update-codemaps`，再把 brownfield snapshot 回落到 `delivery-plan.md` 与 `arch-design.md`。
+5. 若是既有项目（brownfield），先梳理现有模块边界、外部依赖、历史约束和缺失文档；必要时运行 `/update-codemaps`，需要轻量结构证据时选择 Graphify，需要跨模块影响面或 MCP 证据时选择 GitNexus，再把 brownfield snapshot 回落到 `delivery-plan.md` 与 `arch-design.md`。
 6. 若为企业内部应用，锁定应用等级、技术架构等级、关键组件偏离和资产入口要求，并判断是否必须输出 ADR。
 7. 为本次任务显式装配 shared 能力、ECC 增强与可选 enterprise overlay 组合，并说明哪些私有 overlay 能力、runbook 或 overlay 仅按场景启用。
 8. 若存在多参数、多角色、多配置或多终端组合，提前判断是否需要 `pairwise-test-design` 压缩测试矩阵。

package/commands/update-codemaps.md

@@ -4,7 +4,7 @@
 
 ## 用途
 
-扫描代码结构并生成 token-lean codemaps，适合作为 brownfield 项目的现状快照与主链前置上下文。
+扫描代码结构并生成 token-lean codemaps，适合作为 brownfield 项目的现状快照与 Graphify / GitNexus 图谱分析前置上下文。
 
 ## 主责角色
 
@@ -21,6 +21,7 @@
 - docs/CODEMAPS/ 下的结构化 codemap
 - .reports/codemap-diff.txt 差异摘要
 - 可供 `/team-help` / `/team-plan` 消费的 brownfield context
+- 可供 Graphify / GitNexus 继续深挖的结构化问题清单
 
 输出字段定义与交付结构见 [team-command-output-contracts.md](../docs/runbooks/team-command-output-contracts.md)。
 
@@ -29,4 +30,4 @@
 1. 先识别仓库类型、源码目录、入口文件和主要依赖边界。
 2. 为 architecture/backend/frontend/data/dependencies 生成 token-lean 文档，不写实现细节噪音。
 3. 若已有 codemap，先比较变更比例；超过阈值时要求人工确认再覆盖。
-4. 把结果作为 brownfield context snapshot 的辅助输入，回落到 `delivery-plan.md` / `arch-design.md`，不要形成平行事实源。
+4. 把结果作为 brownfield context snapshot 的辅助输入；若需要图谱证据，再选择 Graphify 或 GitNexus，并把结论回落到 `delivery-plan.md` / `arch-design.md`，不要形成平行事实源。

package/docs/.vitepress/config.mts

@@ -0,0 +1,199 @@
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  base: '/harness-engineering/',
+  title: 'Team Skills Platform',
+  description: 'Company-grade role-based Team Skills Platform for AI-assisted development',
+  lang: 'zh-CN',
+  ignoreDeadLinks: true,
+
+  head: [
+    ['link', { rel: 'icon', type: 'image/svg+xml', href: '/logo.svg' }],
+  ],
+
+  themeConfig: {
+    logo: '/logo.svg',
+    siteTitle: 'TSP',
+
+    nav: [
+      { text: '首页', link: '/' },
+      { text: '快速开始', link: '/runbooks/claude-quick-start' },
+      { text: '用户指南', link: '/runbooks/team-skills-usage' },
+      {
+        text: '手册',
+        items: [
+          { text: 'Claude 快速开始', link: '/runbooks/claude-quick-start' },
+          { text: 'Codex 快速开始', link: '/runbooks/codex-quick-start' },
+          { text: 'Cursor 快速开始', link: '/runbooks/cursor-quick-start' },
+          { text: 'OpenCode 快速开始', link: '/runbooks/opencode-quick-start' },
+        ],
+      },
+    ],
+
+    sidebar: {
+      '/guides/': [
+        {
+          text: '指南',
+          items: [
+            { text: '安装（入口页）', link: '/guides/installation' },
+            { text: '用户指南（入口页）', link: '/guides/user-guide' },
+            { text: '权威安装文档', link: '/runbooks/claude-quick-start' },
+            { text: '权威使用手册', link: '/runbooks/team-skills-usage' },
+          ],
+        },
+      ],
+      '/runbooks/': [
+        {
+          text: '快速开始',
+          collapsed: false,
+          items: [
+            { text: 'Claude 快速开始', link: '/runbooks/claude-quick-start' },
+            { text: 'Codex 快速开始', link: '/runbooks/codex-quick-start' },
+            { text: 'Cursor 快速开始', link: '/runbooks/cursor-quick-start' },
+            { text: 'OpenCode 快速开始', link: '/runbooks/opencode-quick-start' },
+            { text: '首次主链演练', link: '/runbooks/first-team-workflow-walkthrough' },
+            { text: '项目接入', link: '/runbooks/project-onboarding' },
+            { text: '故障排查', link: '/runbooks/troubleshooting' },
+          ],
+        },
+        {
+          text: '使用场景',
+          collapsed: true,
+          items: [
+            { text: 'Claude 使用场景', link: '/runbooks/claude-usage-scenarios' },
+            { text: 'Codex 使用场景', link: '/runbooks/codex-usage-scenarios' },
+            { text: 'Solo 交付模式', link: '/runbooks/solo-delivery-mode' },
+            { text: 'Solo 单页速查', link: '/runbooks/solo-delivery-one-page' },
+          ],
+        },
+        {
+          text: '提示与对话',
+          collapsed: true,
+          items: [
+            { text: 'Claude 提示模板', link: '/runbooks/claude-conversation-prompt-recipes' },
+            { text: 'Codex 并行模板', link: '/runbooks/codex-parallel-prompt-recipes' },
+            { text: '角色提示模板', link: '/runbooks/role-prompt-recipes' },
+            { text: 'Claude 完整对话示例', link: '/runbooks/claude-end-to-end-conversation-example' },
+            { text: 'Codex 完整对话示例', link: '/runbooks/codex-end-to-end-conversation-example' },
+          ],
+        },
+        {
+          text: '角色操作手册',
+          collapsed: true,
+          items: [
+            { text: '架构师日常', link: '/runbooks/architect-daily-operations' },
+            { text: '后端工程师日常', link: '/runbooks/backend-engineer-daily-operations' },
+            { text: '产品经理对话示例', link: '/runbooks/product-manager-clarification-conversation-example' },
+            { text: '项目经理规划示例', link: '/runbooks/project-manager-planning-conversation-example' },
+            { text: '架构师设计对话', link: '/runbooks/architect-design-conversation-example' },
+            { text: 'QA 评审对话', link: '/runbooks/qa-review-conversation-example' },
+            { text: 'DevOps 发布对话', link: '/runbooks/devops-release-conversation-example' },
+            { text: 'Tech Lead 收口对话', link: '/runbooks/tech-lead-closure-conversation-example' },
+          ],
+        },
+        {
+          text: '速查手册',
+          collapsed: true,
+          items: [
+            { text: '前端 Bugfix 速查', link: '/runbooks/frontend-bugfix-one-page' },
+            { text: '后端 API 交付速查', link: '/runbooks/backend-api-delivery-one-page' },
+            { text: '发布收口速查', link: '/runbooks/release-closure-one-page' },
+          ],
+        },
+        {
+          text: '平台能力',
+          collapsed: true,
+          items: [
+            { text: '命令与能力矩阵', link: '/runbooks/command-and-capability-matrix' },
+            { text: 'ECC Harness 使用', link: '/runbooks/ecc-harness-usage' },
+            { text: '运行时能力概览', link: '/runbooks/runtime-capabilities-overview' },
+            { text: 'Agent 治理', link: '/runbooks/agent-governance' },
+            { text: 'Sub-agent 调用地图', link: '/runbooks/sub-agent-invocation-map' },
+            { text: 'Handoff 治理', link: '/runbooks/handoff-governance' },
+            { text: '错误经验库', link: '/runbooks/error-experience-usage' },
+            { text: '并行执行', link: '/runbooks/parallel-execution-usage' },
+            { text: '进化系统', link: '/runbooks/evolution-usage' },
+            { text: 'Graphify 知识图谱', link: '/runbooks/graphify-knowledge-graph-usage' },
+          ],
+        },
+        {
+          text: '工程实践',
+          collapsed: true,
+          items: [
+            { text: 'Git PR 工作流', link: '/runbooks/git-pr-workflow' },
+            { text: 'AI PR Review 自动化', link: '/runbooks/ai-pr-review-automation' },
+            { text: '契约测试', link: '/runbooks/contract-testing-playbook' },
+            { text: 'Helm 单元测试', link: '/runbooks/helm-unittest-playbook' },
+            { text: '依赖更新自动化', link: '/runbooks/dependency-update-automation' },
+            { text: 'Release Notes 自动化', link: '/runbooks/release-notes-automation' },
+          ],
+        },
+        {
+          text: 'CI/CD 安全门禁',
+          collapsed: true,
+          items: [
+            { text: 'CodeQL 安全门禁', link: '/runbooks/codeql-pr-security-gates' },
+            { text: 'Secret Scanning', link: '/runbooks/secret-scanning-gates' },
+            { text: 'Trivy 安全扫描', link: '/runbooks/trivy-security-gates' },
+            { text: 'Checkov IaC 门禁', link: '/runbooks/checkov-iac-gates' },
+            { text: 'API Lint 门禁', link: '/runbooks/api-lint-gates' },
+            { text: 'API Breaking Change', link: '/runbooks/api-breaking-change-gates' },
+            { text: 'Reviewdog PR 门禁', link: '/runbooks/reviewdog-pr-gates' },
+            { text: 'Scorecard 供应链', link: '/runbooks/scorecard-supply-chain-gates' },
+            { text: 'SBOM 生成', link: '/runbooks/sbom-generation-gates' },
+            { text: 'Cosign 签名', link: '/runbooks/cosign-signing-gates' },
+            { text: 'SLSA 验证', link: '/runbooks/slsa-verification-gates' },
+          ],
+        },
+        {
+          text: '企业扩展',
+          collapsed: true,
+          items: [
+            { text: '企业扩展快速开始', link: '/runbooks/enterprise-extension-quick-start' },
+            { text: '公司技能集成', link: '/runbooks/company-skills-integration' },
+            { text: '公司技能决策框架', link: '/runbooks/company-skills-decision-framework' },
+            { text: '外部能力引入', link: '/runbooks/external-capability-intake' },
+            { text: '企业标准映射', link: '/runbooks/enterprise-standards-mapping' },
+          ],
+        },
+        {
+          text: '历史档案',
+          collapsed: true,
+          items: [
+            { text: '版本收口（2026-03-29）', link: '/runbooks/version-closure-2026-03-29' },
+            { text: '平台能力演示剧本（历史）', link: '/runbooks/platform-capability-demo-script' },
+            { text: '平台能力演示执行记录（历史）', link: '/runbooks/platform-capability-demo-execution-log' },
+            { text: '平台迁移计划（历史）', link: '/plans/team-skills-platform-migration' },
+          ],
+        },
+      ],
+    },
+
+    search: {
+      provider: 'local',
+    },
+
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/Colin4k1024/harness-engineering' },
+    ],
+
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: '© 2026 Team Skills Platform',
+    },
+
+    outline: {
+      level: [2, 3],
+      label: '页面导航',
+    },
+
+    lastUpdated: {
+      text: '最后更新',
+    },
+
+    docFooter: {
+      prev: '上一页',
+      next: '下一页',
+    },
+  },
+})

package/docs/adr/ADR-001-doc-architecture-integration.md

@@ -0,0 +1,33 @@
+---
+artifact: adr
+task: doc-architecture-demo
+date: 2026-04-01
+role: architect
+status: draft
+---
+
+# ADR-001: Doc Architecture Integration
+
+## 决策信息
+- 编号：ADR-001
+- 标题：将文档架构能力集成到 team 主链
+- 状态：Accepted
+- 决策日期：2026-04-01
+- Owner：architect
+
+## 背景与约束
+- 背景：原能力存在独立文档目录习惯，当前平台要求统一 artifact 持久化。
+- 约束：不得新增并行主命令，不得破坏角色边界。
+
+## 备选方案
+- 方案 A：新增 team-doc-architect 命令。
+- 方案 B：角色内嵌 shared skill + 现有命令契约增强。
+- 结论：采用方案 B。
+
+## 决策结果
+- 采用 `doc-architecture` shared skill。
+- 通过 artifact-standards 与输出契约扩展保证落盘一致性。
+- 回退思路：若复杂度过高，先仅在 tech-lead/architect 启用。
+
+## 后续动作
+- 在后续任务中持续验证主链闭环。

package/docs/guides/README.md

@@ -0,0 +1,5 @@
+# Guides Index
+
+| 文档 | 说明 |
+|------|------|
+| [user-guide.md](user-guide.md) | 完整用户指南，包含项目概述、快速开始、核心概念、命令详解等 |

package/docs/guides/installation.md

@@ -0,0 +1,33 @@
+---
+version: "2.3.0"
+status: active
+created: 2026-04-17
+updated: 2026-04-18
+owner: 工程团队
+doc_tier: redirect
+last_verified: 2026-04-18
+source_of_truth:
+  - ../runbooks/claude-quick-start.md
+  - ../runbooks/codex-quick-start.md
+  - ../runbooks/project-onboarding.md
+  - ../runbooks/troubleshooting.md
+---
+
+# 安装指南（入口页）
+
+本页作为**薄入口**保留，不再承载安装细节。安装与排障的权威内容统一维护在 runbooks：
+
+- Claude：[/runbooks/claude-quick-start](../runbooks/claude-quick-start.md)
+- Codex：[/runbooks/codex-quick-start](../runbooks/codex-quick-start.md)
+- Cursor：[/runbooks/cursor-quick-start](../runbooks/cursor-quick-start.md)
+- OpenCode：[/runbooks/opencode-quick-start](../runbooks/opencode-quick-start.md)
+- 项目接入：[/runbooks/project-onboarding](../runbooks/project-onboarding.md)
+- 故障排查：[/runbooks/troubleshooting](../runbooks/troubleshooting.md)
+
+## 最短路径
+
+1. 选择目标平台 quick start。
+2. 完成安装后先执行 `/team-help`。
+3. 正式任务产出按 `artifact:persist` 写回项目仓库。
+
+> 说明：为避免入口层双写漂移，本页不再维护版本 tarball、脚本细节与示例命令。

package/docs/guides/user-guide.md

@@ -0,0 +1,36 @@
+---
+version: "2.3.0"
+status: active
+created: 2026-04-17
+updated: 2026-04-18
+owner: 工程团队
+doc_tier: redirect
+last_verified: 2026-04-18
+source_of_truth:
+  - ../runbooks/team-skills-usage.md
+  - ../runbooks/command-and-capability-matrix.md
+  - ../runbooks/project-onboarding.md
+  - ../runbooks/troubleshooting.md
+---
+
+# 用户指南（入口页）
+
+本页作为**薄入口**保留，不再维护完整使用手册正文。权威内容统一在 runbooks：
+
+- 主手册：[/runbooks/team-skills-usage](../runbooks/team-skills-usage.md)
+- 命令矩阵：[/runbooks/command-and-capability-matrix](../runbooks/command-and-capability-matrix.md)
+- 项目接入：[/runbooks/project-onboarding](../runbooks/project-onboarding.md)
+- 故障排查：[/runbooks/troubleshooting](../runbooks/troubleshooting.md)
+
+## 推荐阅读顺序
+
+1. `/runbooks/command-and-capability-matrix`
+2. `/runbooks/team-skills-usage`
+3. `/runbooks/project-onboarding`
+4. `/runbooks/troubleshooting`
+
+## 主链入口提醒
+
+无论从哪份手册进入，正式任务都建议先执行 `/team-help` 判断主链入口，再进入 `/team-intake` 或 `/quick`。
+
+> 说明：本页不再维护重复命令清单与安装示例，避免与 runbooks 并行漂移。

package/docs/index.md

@@ -0,0 +1,65 @@
+---
+layout: home
+status: active
+updated: 2026-04-17
+owner: 工程团队
+doc_tier: entry
+last_verified: 2026-04-17
+source_of_truth:
+  - ../README.md
+  - ../AGENTS.md
+  - ./runbooks/command-and-capability-matrix.md
+
+hero:
+  name: Team Skills Platform
+  text: 角色化 AI 研发团队
+  tagline: 200+ Skills · 8 Roles · 多平台支持 — 内置 /team-help、brownfield 补齐与 story-sized execution
+  actions:
+    - theme: brand
+      text: 快速开始
+      link: /runbooks/claude-quick-start
+    - theme: alt
+      text: 用户指南
+      link: /runbooks/team-skills-usage
+    - theme: alt
+      text: GitHub
+      link: https://github.com/Colin4k1024/tsp
+
+features:
+  - icon: 🧭
+    title: 单入口主链
+    details: 通过 /team-help 统一判断当前应该进入 intake、plan 还是先补 brownfield 文档、project context 与 readiness 证据，降低首次接入成本。
+  - icon: 👥
+    title: 角色化协作
+    details: Tech Lead 编排 + 产品、架构、前端、后端、测试、运维 8 个专业角色协作，每个角色有明确的职责边界和交接规则。
+  - icon: ⚡
+    title: 200+ AI Skills
+    details: 覆盖调试验证、编排效率、学习记忆、进化复用等多个维度，包含前端工程、后端模式、安全审查、TDD 等专项能力。
+  - icon: 🔧
+    title: 多平台支持
+    details: 一套定义，同时支持 Claude Code、Codex、Cursor、OpenCode 四个平台，通过 npx 一键安装。
+  - icon: 🏗️
+    title: ECC Harness Layer
+    details: Specialist agents、快捷命令、分层规则、运行时 hooks、上下文管理、成本追踪与持续学习等工程增强能力。
+  - icon: 🧩
+    title: BMAD 经验吸收
+    details: 已吸收 implementation-readiness、brownfield/document-project、Story Slice Plan 与阶段化 readiness gate，不额外引入第二套平行框架。
+  - icon: 🕸️
+    title: Graphify 可选能力
+    details: 提供 brownfield 结构扫描、依赖路径分析与架构问答证据，作为 `/team-*` 主链的可选补充而非替代引擎。
+  - icon: 🎨
+    title: 前端治理
+    details: React/Next 优先的工程规范 + UI/UX 设计知识库 + 强制质量门禁，从 intake 到 release 全链路覆盖。
+  - icon: 🏢
+    title: 企业级扩展
+    details: 支持公司领域 Skill 扩展、企业架构治理、组件基线、数据库/缓存规范，可对齐集团标准。
+---
+
+## 文档生命周期字段
+
+| 字段 | 值 | 说明 |
+|------|----|------|
+| `status` | `active` | 首页属于公开入口，作为文档导航首屏 |
+| `doc_tier` | `entry` | 入口层文档；不承载与 runbooks 重复的细节说明 |
+| `last_verified` | `2026-04-17` | 最近一次入口链路回归核对日期 |
+| `source_of_truth` | `README.md`、`AGENTS.md`、`runbooks/command-and-capability-matrix.md` | 命令面与入口说明的权威来源 |

package/docs/memory/backlog.md

@@ -0,0 +1,10 @@
+# Backlog
+
+## 2026-04-21 - Community adoption follow-up
+
+The release-blocking open-source readiness gaps from this round are closed: public installer surface is aligned, support depth is now documented, CI enforces the declared doc/reference gates, and prebuilt binaries are treated as release/package artifacts instead of git-tracked assets.
+
+Next follow-ups are now narrowly adoption-oriented:
+
+- Add minimal quick-start stubs or examples for `antigravity`, `codebuddy`, `gemini`, `copilot`, `windsurf`, and `augment` if community usage warrants it.
+- Keep the new `npm run release:health` summary and `open-source-release-checklist.md` aligned with future support-surface changes.