mancode 0.1.0 → 0.2.1

package/README.md

@@ -11,14 +11,14 @@
 
 <p align="center">
   Adapts to common coding agent tools, including Claude Code, Cursor, Codex CLI,
-  and GitHub Copilot.
+  GitHub Copilot, and ZCode.
 </p>
 
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="License: AGPL-3.0" /></a>
-  <img src="https://img.shields.io/badge/status-stable%20v0.1.0-green?style=flat-square" alt="Status: stable v0.1.0" />
-  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot-5865F2?style=flat-square" alt="Platforms: Claude Code, Cursor, Codex CLI, GitHub Copilot" />
-  <img src="https://img.shields.io/badge/tests-256%20passed-brightgreen?style=flat-square" alt="Tests: 256 passed" />
+  <img src="https://img.shields.io/badge/status-stable%20v0.2.0-green?style=flat-square" alt="Status: stable v0.2.0" />
+  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="Platforms: Claude Code, Cursor, Codex CLI, GitHub Copilot, ZCode" />
+  <img src="https://img.shields.io/badge/tests-313%20passed-brightgreen?style=flat-square" alt="Tests: 305 passed" />
 </p>
 
 <p align="center">
@@ -34,10 +34,10 @@ different gears for different stakes: light solo mode for daily practice, `/man`
 for playoff-level engineering discipline, and coaching-staff subagents for
 research, planning, implementation, and review.
 
-mancode ships with adapters for Claude Code, Cursor, Codex CLI, and
-GitHub Copilot. Claude Code gets the full hooks, skills, and subagents setup;
-the other adapters receive durable rules or instruction files with documented
-capability downgrades.
+mancode ships with adapters for Claude Code, Cursor, Codex CLI, GitHub Copilot,
+and ZCode. Claude Code gets the full hooks, skills, and subagents setup; the
+other adapters receive durable rules, skills, or instruction files with
+documented capability downgrades.
 
 mancode installs three things:
 
@@ -82,7 +82,9 @@ testing, and multi-agent review: playoffs, every possession counts.
 .claude/                         # Claude Code: hooks, skills, agents
 .cursor/rules/                   # Cursor: project rules
 AGENTS.md                        # Codex CLI: managed instruction block
+.agents/skills/                   # Codex CLI: mode skills
 .github/copilot-instructions.md  # GitHub Copilot: managed instruction block
+.agents/skills/                   # ZCode: project mode skills
 ```
 
 `.mancode/` stores local state, project style signals, workflow reports, and
@@ -232,8 +234,9 @@ it should behave, and why previous decisions were made.
 
 ## Installation
 
-**Status**: stable v0.1.0. Claude Code, Cursor, Codex CLI, and GitHub Copilot are
-supported.
+**Status**: stable v0.2.0. Claude Code, Cursor, Codex CLI, and GitHub Copilot
+are supported. ZCode adapter support is included, with project skill discovery
+kept behind a verification gate before release.
 
 ```bash
 npm install -g mancode
@@ -248,6 +251,9 @@ Supported platforms:
 - Cursor: `.cursor/rules/*.mdc` rules
 - Codex CLI: managed `AGENTS.md` block
 - GitHub Copilot: managed `.github/copilot-instructions.md` block
+- ZCode: managed `AGENTS.md` block and provisional `$man*` skills in
+  `.agents/skills/`; project skill discovery and slash commands pending verified
+  workspace paths
 - Windsurf, Cline, Roo Code: planned later
 
 ### Install Options
@@ -258,7 +264,7 @@ mancode init --yes        # Skip confirmations for CI usage
 mancode init --team       # Force-enable team mode
 mancode init --no-team    # Force-disable team mode
 mancode init --style NAME # Save a default style preference
-mancode init --platform PLATFORM # Initialize for claude-code, cursor, codex, or copilot
+mancode init --platform PLATFORM # Initialize for claude-code, cursor, codex, copilot, or zcode
 mancode install --force   # Reinstall adapter while preserving scanned tokens
 mancode install --minimal # Install only solo-mode essentials
 ```
@@ -279,7 +285,7 @@ mancode install --minimal # Install only solo-mode essentials
 mancode init
 mancode status
 mancode status --json
-mancode install <claude-code|cursor|codex|copilot>
+mancode install <claude-code|cursor|codex|copilot|zcode>
 mancode list-platforms
 mancode workflow create <man8|man> "<task>"
 mancode workflow update <taskId> [--step N] [--status in_progress|completed|abandoned]
@@ -296,7 +302,7 @@ mancode version
 ### `mancode status`
 
 ```text
-mancode v0.1.0
+mancode v0.2.0
 
 Project:     my-app (React + TypeScript + Tailwind)
 Mode:        solo (default)
@@ -309,12 +315,14 @@ Installed platforms:
   ✓ Cursor
   ✓ Codex CLI
   ✓ GitHub Copilot
+  ✓ ZCode
 
 Platform status:
   ✓ Claude Code: ready (.claude/)
   ✓ Cursor: ready (.cursor/rules/)
-  ✓ Codex CLI: ready (AGENTS.md)
+  ✓ Codex CLI: ready (AGENTS.md + .agents/skills/)
   ✓ GitHub Copilot: ready (.github/copilot-instructions.md)
+  ✓ ZCode: ready (AGENTS.md + .agents/skills/)
 
 Hooks:
   ✓ session-start.sh
@@ -461,14 +469,20 @@ run `mancode install claude-code --force` to rewrite the settings.
 
 This means the platform's target files are missing. Run
 `mancode install <platform> --force` to regenerate them. For managed-block
-platforms (Codex, Copilot), the managed block in `AGENTS.md` or
+platforms (Codex, ZCode, Copilot), the managed block in `AGENTS.md` or
 `.github/copilot-instructions.md` may have been manually edited or deleted.
 
 ### AGENTS.md or copilot-instructions.md managed block was accidentally deleted
 
-Run `mancode install codex --force` (or `copilot`) to reinsert the managed
-block. User-authored content outside the `<!-- mancode:start -->` and
-`<!-- mancode:end -->` markers is preserved.
+Run `mancode install codex --force` (or `zcode`, or `copilot`) to reinsert the
+managed block. User-authored content outside the relevant mancode managed
+markers is preserved.
+
+### ZCode skills not appearing
+
+Ensure `.agents/skills/man8/SKILL.md` through `.agents/skills/mansolo/SKILL.md`
+exist, then restart or refresh ZCode. ZCode slash commands are not generated
+yet because the workspace command file path still needs explicit verification.
 
 ### Cursor rules not triggering
 
@@ -522,9 +536,10 @@ are opt-in for work that needs planning, tests, and review.
 
 ### Does mancode work outside Claude Code?
 
-Yes. mancode supports Cursor, Codex CLI, and GitHub Copilot through
-persistent project rules or instruction files. Claude Code remains the richest
-adapter because it supports hooks, skills, and subagents.
+Yes. mancode supports Cursor, Codex CLI, GitHub Copilot, and experimental ZCode
+adaptation through persistent project rules, skills, or instruction files.
+Claude Code remains the richest adapter because it supports hooks, skills, and
+subagents.
 
 ### Can mancode help with frontend consistency?
 

package/README.zh-CN.md

@@ -10,14 +10,14 @@
 </p>
 
 <p align="center">
-  适配常见编程代理工具，Claude Code、Cursor、Codex CLI 和 GitHub Copilot。
+  适配常见编程代理工具，Claude Code、Cursor、Codex CLI、GitHub Copilot 和 ZCode。
 </p>
 
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=flat-square" alt="许可证：AGPL-3.0" /></a>
-  <img src="https://img.shields.io/badge/status-stable%20v0.1.0-green?style=flat-square" alt="状态：稳定版 v0.1.0" />
-  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot-5865F2?style=flat-square" alt="平台：Claude Code、Cursor、Codex CLI、GitHub Copilot" />
-  <img src="https://img.shields.io/badge/tests-256%20passed-brightgreen?style=flat-square" alt="测试：256 通过" />
+  <img src="https://img.shields.io/badge/status-stable%20v0.2.0-green?style=flat-square" alt="状态：稳定版 v0.2.0" />
+  <img src="https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20Copilot%20%7C%20ZCode-5865F2?style=flat-square" alt="平台：Claude Code、Cursor、Codex CLI、GitHub Copilot、ZCode" />
+  <img src="https://img.shields.io/badge/tests-313%20passed-brightgreen?style=flat-square" alt="测试：305 通过" />
 </p>
 
 <p align="center">
@@ -32,9 +32,9 @@
 日常任务用轻量 `solo`，关键任务用季后赛级别的 `/man`，复杂任务让教练组 subagents
 负责调研、计划、实现和审查。
 
-mancode 当前支持 Claude Code、Cursor、Codex CLI 和 GitHub Copilot。Claude Code
-获得完整 hooks、skills 和 subagents；其他平台通过持久化 rules 或 instructions 文件提供
-降级适配。
+mancode 当前支持 Claude Code、Cursor、Codex CLI、GitHub Copilot 和 ZCode。
+Claude Code 获得完整 hooks、skills 和 subagents；其他平台通过持久化 rules、
+skills 或 instructions 文件提供降级适配。
 
 mancode 会安装三类能力：
 
@@ -76,7 +76,9 @@ mancode init
 .claude/                         # Claude Code：hooks、skills、agents
 .cursor/rules/                   # Cursor：项目 rules
 AGENTS.md                        # Codex CLI：托管 instruction block
+.agents/skills/                   # Codex CLI：mode skills
 .github/copilot-instructions.md  # GitHub Copilot：托管 instruction block
+.agents/skills/                   # ZCode：项目 mode skills
 ```
 
 `.mancode/` 保存本地状态、项目风格信号、工作流报告和团队记忆。平台文件保存对应
@@ -209,7 +211,8 @@ src/components/
 
 ## 安装
 
-**状态**：稳定版 v0.1.0。Claude Code、Cursor、Codex CLI 和 GitHub Copilot 均已支持。
+**状态**：稳定版 v0.2.0。Claude Code、Cursor、Codex CLI 和 GitHub Copilot
+均已支持。ZCode adapter 已接入，但项目级 skill 发现路径在发布前仍作为验证门禁。
 
 ```bash
 npm install -g mancode
@@ -224,6 +227,8 @@ mancode init --platform cursor
 - Cursor：`.cursor/rules/*.mdc` rules
 - Codex CLI：托管 `AGENTS.md` block
 - GitHub Copilot：托管 `.github/copilot-instructions.md` block
+- ZCode：托管 `AGENTS.md` block，并暂按 `.agents/skills/` 生成 `$man*`
+  skills；项目级 skill 发现和 slash commands 仍需确认 workspace 路径后再发布承诺
 - Windsurf、Cline、Roo Code：后续计划
 
 ### 安装参数
@@ -234,7 +239,7 @@ mancode init --yes        # CI 场景跳过确认
 mancode init --team       # 强制启用团队模式
 mancode init --no-team    # 强制禁用团队模式
 mancode init --style NAME # 保存默认审美偏好
-mancode init --platform PLATFORM # 初始化 claude-code、cursor、codex 或 copilot
+mancode init --platform PLATFORM # 初始化 claude-code、cursor、codex、copilot 或 zcode
 mancode install --force   # 重装适配并保留已扫描 token
 mancode install --minimal # 只安装 solo 必需文件
 ```
@@ -255,7 +260,7 @@ mancode install --minimal # 只安装 solo 必需文件
 mancode init
 mancode status
 mancode status --json
-mancode install <claude-code|cursor|codex|copilot>
+mancode install <claude-code|cursor|codex|copilot|zcode>
 mancode list-platforms
 mancode workflow create <man8|man> "<task>"
 mancode workflow update <taskId> [--step N] [--status in_progress|completed|abandoned]
@@ -272,7 +277,7 @@ mancode version
 ### `mancode status`
 
 ```text
-mancode v0.1.0
+mancode v0.2.0
 
 Project:     my-app (React + TypeScript + Tailwind)
 Mode:        solo (default)
@@ -285,12 +290,14 @@ Installed platforms:
   ✓ Cursor
   ✓ Codex CLI
   ✓ GitHub Copilot
+  ✓ ZCode
 
 Platform status:
   ✓ Claude Code: ready (.claude/)
   ✓ Cursor: ready (.cursor/rules/)
-  ✓ Codex CLI: ready (AGENTS.md)
+  ✓ Codex CLI: ready (AGENTS.md + .agents/skills/)
   ✓ GitHub Copilot: ready (.github/copilot-instructions.md)
+  ✓ ZCode: ready (AGENTS.md + .agents/skills/)
 
 Hooks:
   ✓ session-start.sh
@@ -432,13 +439,19 @@ mancode 要求目标目录有 `.git` 或 `package.json`。请在 git 仓库或 N
 ### `mancode status` 显示某平台 "not ready"
 
 该平台的目标文件缺失。运行 `mancode install <platform> --force` 重新生成。
-对于 Codex 和 Copilot，`AGENTS.md` 或 `.github/copilot-instructions.md`
+对于 Codex、ZCode 和 Copilot，`AGENTS.md` 或 `.github/copilot-instructions.md`
 中的受控区可能被手动编辑或删除了。
 
 ### AGENTS.md 或 copilot-instructions.md 受控区被误删
 
-运行 `mancode install codex --force`（或 `copilot`）重新插入受控区。
-`<!-- mancode:start -->` 和 `<!-- mancode:end -->` 标记外的用户内容会被保留。
+运行 `mancode install codex --force`（或 `zcode`、`copilot`）重新插入受控区。
+对应 mancode 受控标记外的用户内容会被保留。
+
+### ZCode skills 未出现
+
+确认 `.agents/skills/man8/SKILL.md` 到 `.agents/skills/mansolo/SKILL.md`
+都存在，然后重启或刷新 ZCode。当前尚不生成 ZCode `/man*` slash commands，
+因为 workspace command 的文件路径仍需显式验证。
 
 ### Cursor rules 不触发
 
@@ -488,9 +501,9 @@ hooks。用户自定义的 rules 和 instructions 会被保留。
 
 ### mancode 支持 Claude Code 以外的平台吗？
 
-支持。mancode 已通过持久化 rules 或 instruction 文件支持 Cursor、Codex CLI 和
-GitHub Copilot。Claude Code 仍是能力最完整的 adapter，因为它支持 hooks、skills 和
-subagents。
+支持。mancode 已通过持久化 rules、skills 或 instruction 文件支持 Cursor、Codex
+CLI、GitHub Copilot，并提供实验性 ZCode adapter。Claude Code 仍是能力最完整的
+adapter，因为它支持 hooks、skills 和 subagents。
 
 ### mancode 能改善前端一致性吗？