Skip to content

Commit 2e7a2be

Browse files
nilecuinilecui
committed
first commit
0 parents  commit 2e7a2be

24 files changed

Lines changed: 3401 additions & 0 deletions

‎.claude-plugin/marketplace.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"name": "harness-zh",
3+
"description": "Harness-ZH Marketplace · 简体中文 Agent Team & Skill Architect",
4+
"plugins": [
5+
{
6+
"name": "harness-zh",
7+
"source": ".",
8+
"description": "Simplified Chinese meta-skill that designs multi-agent teams and the skills they use for any domain or project."
9+
}
10+
]
11+
}

‎.claude-plugin/plugin.json‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"name": "harness-zh",
3+
"description": "Agent Team & Skill Architect (Simplified Chinese). Meta-skill for Claude Code that designs domain-specific agent teams, defines specialized agents, and generates the skills they use. 面向 Claude Code 的简体中文元技能：为任意领域自动设计多智能体团队、定义专家智能体，并生成团队协作所需的技能。",
4+
"version": "2.0.0",
5+
"author": {
6+
"name": "harness-zh maintainers",
7+
"url": "https://github.com/<your-github-user>/harness-zh"
8+
},
9+
"homepage": "https://github.com/<your-github-user>/harness-zh",
10+
"repository": "https://github.com/<your-github-user>/harness-zh",
11+
"license": "Apache-2.0",
12+
"keywords": [
13+
"harness",
14+
"harness-zh",
15+
"agent-team",
16+
"skill-architect",
17+
"meta-skill",
18+
"orchestration",
19+
"claude-code",
20+
"simplified-chinese",
21+
"zh-hans"
22+
]
23+
}

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
name: Bug 报告 / Bug report
3+
about: 报告 Harness-ZH 的错误行为或触发问题
4+
title: "[Bug] "
5+
labels: bug
6+
assignees: ''
7+
---
8+
9+
## 环境信息
10+
11+
- Claude Code 版本：
12+
- 安装方式：☐ 插件市场 ☐ 全局 skill ☐ 项目级
13+
- 操作系统：
14+
- Harness-ZH 版本：
15+
16+
## 现象
17+
18+
清晰描述观察到的问题。
19+
20+
## 重现步骤
21+
22+
1. 触发 prompt：`…`
23+
2. Skill 响应：`…`
24+
3. 期望行为：`…`
25+
4. 实际行为：`…`
26+
27+
## 相关产物
28+
29+
- 生成的 `.claude/agents/*.md`（可贴关键片段）：
30+
- 生成的 `.claude/skills/*/SKILL.md`（可贴关键片段）：
31+
- CLAUDE.md trigger 指针：
32+
33+
## 日志 / 截图
34+
35+
```
36+
<粘贴相关日志或 Claude Code 会话片段>
37+
```
38+
39+
## 其他上下文
40+
41+
是否与上游 `revfactory/harness` 或其他 skill 同时使用？是否有自定义 agent？

‎.github/ISSUE_TEMPLATE/feature_request.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
name: 功能建议 / Feature request
3+
about: 提议新的架构模式、QA 维度、领域示例或工作流改进
4+
title: "[Feature] "
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
## 动机
10+
11+
当前哪个场景无法很好地被现有 skill 覆盖？期望解决什么问题？
12+
13+
## 方案
14+
15+
建议的新功能 / 改动点：
16+
17+
- [ ] 新架构模式 / 执行模式
18+
- [ ] 新 QA 维度
19+
- [ ] 新领域示例
20+
- [ ] 新触发短语
21+
- [ ] 文档 / 工作流优化
22+
- [ ] 其他：
23+
24+
具体描述：
25+
26+
## 替代方案
27+
28+
是否考虑过其他方案？为什么选择当前方案？
29+
30+
## 兼容性影响
31+
32+
- 是否影响现有触发行为？
33+
- 是否影响生成物结构（`.claude/agents/`、`.claude/skills/`）？
34+
- 是否影响模型策略？
35+
36+
## 其他上下文
37+
38+
参考资料、相关 issue/PR、上游动向。

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
## 概述
2+
3+
一句话说明本 PR 做了什么、为什么做。
4+
5+
## 改动类型
6+
7+
- [ ] 文档（不影响功能）
8+
- [ ] 新功能（向后兼容）
9+
- [ ] 破坏性变更（需要用户适配）
10+
- [ ] Bug 修复
11+
- [ ] 性能 / 上下文优化
12+
- [ ] 重构（无功能变化）
13+
14+
## 详细说明
15+
16+
描述具体改动，列出涉及的文件：
17+
18+
- `skills/harness-zh/SKILL.md` — …
19+
- `skills/harness-zh/references/…` — …
20+
- `docs/…` — …
21+
22+
## 自检清单
23+
24+
- [ ] 文件内无韩文残留（可用 `grep -r '[가-힣]' skills/` 验证为空）
25+
- [ ] Phase 编号未被打乱
26+
- [ ] 新增章节在 SKILL.md 或其他文档中已添加指针
27+
- [ ] CHANGELOG.md 已记录本次改动
28+
- [ ] 已阅读 [CONTRIBUTING.md](../CONTRIBUTING.md)
29+
- [ ] 若影响触发行为，已在本 PR 描述中明确说明
30+
31+
## 测试证据
32+
33+
- [ ] 已在 Claude Code 中手动验证 skill 仍能被正确触发
34+
- [ ] （可选）跑了 with-skill vs without-skill A/B，提交了 `evaluation/` 下的对比结果
35+
- [ ] （可选）跑了对抗性测试变体
36+
37+
## 关联 Issue
38+
39+
Closes #

‎.github/dependabot.yml‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
version: 2
2+
updates:
3+
- package-ecosystem: "github-actions"
4+
directory: "/"
5+
schedule:
6+
interval: "monthly"
7+
open-pull-requests-limit: 5
8+
labels:
9+
- "dependencies"
10+
- "github-actions"

‎.github/workflows/lint.yml‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
name: Lint
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
branches: [main]
8+
9+
jobs:
10+
markdown-lint:
11+
name: Markdown Lint
12+
runs-on: ubuntu-latest
13+
steps:
14+
- uses: actions/checkout@v4
15+
- name: Setup Node
16+
uses: actions/setup-node@v4
17+
with:
18+
node-version: '20'
19+
- name: Install markdownlint-cli2
20+
run: npm install -g markdownlint-cli2
21+
- name: Run markdownlint
22+
run: markdownlint-cli2 "**/*.md" "#node_modules"
23+
24+
no-korean-leak:
25+
name: No Korean Leak (body must be Chinese)
26+
runs-on: ubuntu-latest
27+
steps:
28+
- uses: actions/checkout@v4
29+
- name: Scan Korean characters in skill bodies
30+
run: |
31+
# Allow Korean only in SKILL.md frontmatter? This fork is fully Chinese,
32+
# so any Korean character is considered a leak.
33+
if grep -Pr '[\x{AC00}-\x{D7A3}]' skills/ docs/ --include='*.md' | grep -v '^Binary'; then
34+
echo "::error::Found Korean characters in Chinese skill/doc files."
35+
exit 1
36+
fi
37+
echo "OK: no Korean characters detected."
38+
39+
structure-check:
40+
name: Structure Check
41+
runs-on: ubuntu-latest
42+
steps:
43+
- uses: actions/checkout@v4
44+
- name: Ensure required files exist
45+
run: |
46+
set -e
47+
test -f README.md
48+
test -f LICENSE
49+
test -f CHANGELOG.md
50+
test -f CONTRIBUTING.md
51+
test -f CODE_OF_CONDUCT.md
52+
test -f .claude-plugin/plugin.json
53+
test -f .claude-plugin/marketplace.json
54+
test -f skills/harness-zh/SKILL.md
55+
for f in agent-design-patterns orchestrator-template qa-agent-guide skill-testing-guide skill-writing-guide team-examples; do
56+
test -f "skills/harness-zh/references/$f.md" || { echo "Missing references/$f.md"; exit 1; }
57+
done
58+
echo "Structure OK"
59+
- name: Validate plugin.json
60+
run: |
61+
python3 -c "import json; json.load(open('.claude-plugin/plugin.json'))"
62+
python3 -c "import json; json.load(open('.claude-plugin/marketplace.json'))"

‎.gitignore‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# macOS
2+
.DS_Store
3+
4+
# 编辑器/IDE
5+
.vscode/
6+
.idea/
7+
*.swp
8+
*.swo
9+
*~
10+
11+
# 临时文件
12+
*.tmp
13+
*.bak
14+
*.log
15+
16+
# 测试与评估产物
17+
evaluation/
18+
.eval_cache/
19+
20+
# 本地 Claude Code 生成物（不提交到仓库）
21+
.claude/agents/
22+
.claude/skills/*/cache/

‎.markdownlint.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"default": true,
3+
"MD013": false,
4+
"MD024": { "siblings_only": true },
5+
"MD033": false,
6+
"MD041": false,
7+
"MD036": false
8+
}

‎CHANGELOG.md‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# Changelog
2+
3+
本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
4+
5+
## [2.0.0] — 2026-04-15
6+
7+
首个面向公众的正式发布版本。基于上游 `revfactory/harness` 的 v1.2.0 韩文原版，完整重构为简体中文并新增生产级 QA/测试维度。
8+
9+
### Added
10+
- **QA 时序一致性维度**（`references/qa-agent-guide.md` §2-5）
11+
- 6 步验证流程：异步操作识别 → 幂等性 → 并发写冲突 → 回调乱序 → 超时补偿 → 缓存失效
12+
- 5 类常见时序 bug 模式对照表
13+
- 最终检查清单新增 6 项
14+
- **对抗性测试变体**（`references/skill-testing-guide.md`）
15+
- 4 类扰动：输入残缺 / 格式异常 / 矛盾指令 / 多义表达
16+
- 差异化评估标准（不要求产出完美，但禁止 silent failure）
17+
- **触发短语扩展**（SKILL.md frontmatter）
18+
- 新增第 6 类：「组织 agent」「多 agent 协作」「搭建自动化流程」「agent 怎么分工」等泛化表达
19+
- **领域示例新增**（`qa-agent-guide.md`）
20+
- §6 Web 应用（Next.js）
21+
- §7 数据管道
22+
- **分级模型策略**（SKILL.md）
23+
- 新增"任务复杂度 × 推荐模型"表
24+
- 允许低复杂度结构化任务降级为 sonnet
25+
26+
### Changed
27+
- **模型策略松绑**：由"所有 agent 硬性 `model: opus`"改为"默认 opus，允许 sonnet 分级"。依赖全 opus 的上层调用方需显式感知此变化。
28+
- **QA 方法论泛化**：`qa-agent-guide.md` §2 从 Next.js 专属改写为领域中性，具体域示例独立成节。
29+
- **文档瘦身**：
30+
- `SKILL.md` 443 → 356 行（-20%），执行模式示意图迁移至 `orchestrator-template.md`
31+
- `orchestrator-template.md` 428 → 267 行（-38%），删除 ~160 行冗余"Phase 再叙述"
32+
- 数据传递策略矩阵从 SKILL.md 迁至 orchestrator-template.md
33+
- **Skill 标识**：`name: harness_zh` → `name: harness-zh`（符合 Claude Code 命名约定，使用连字符）
34+
35+
### Removed
36+
- SKILL.md 中的 `cloud-deploy/` 目录树示例
37+
- SKILL.md 中的显式变更历史 markdown 代码块示例
38+
- `qa-agent-guide.md` 中的 SatangSlide 项目特定内容（保留方法论，移除项目归属）
39+
40+
### Preserved
41+
- Phase 0–7 命名、顺序、子 phase 结构
42+
- 6 种架构模式（Pipeline / Fan-out·Fan-in / Expert Pool / Producer-Reviewer / Supervisor / Hierarchical Delegation）
43+
- 3 种执行模式（Agent Teams / Subagents / Hybrid）
44+
- 完整参考文档集（6 份）
45+
46+
### Migration Notes
47+
从 `revfactory/harness` 上游切换到本版本：
48+
- **Skill 名不同**，两者可并存安装，不会冲突。
49+
- **模型约束变化**：若你有外部校验"全 agent 必须 opus"，需调整为"必须指定 `model` 字段"。
50+
- **触发短语扩展**：本版本命中面更广，可能在不希望激活 harness 的"泛 agent 讨论"中被触发；可在会话中显式说「不使用 harness-zh skill」。
51+
52+
## [1.0.0-internal] — 2026-04-15
53+
54+
内部 v1 版本，未公开发布。主要变化：
55+
- 从韩文原版重构为中文
56+
- 文档瘦身（SKILL -20%、Orchestrator -38%）
57+
- 触发短语与领域示例扩展
58+
- 模型策略分级化
59+
60+
未收录 QA 时序一致性与对抗性测试——这两项于 v2.0.0 补齐。
61+
62+
---
63+
64+
## 上游版本关联
65+
66+
本仓库上游：[revfactory/harness](https://github.com/revfactory/harness)，当前参照其 `v1.2.0`（2026-03 前后）。
67+
68+
[2.0.0]: https://github.com/<your-github-user>/harness-zh/releases/tag/v2.0.0

0 commit comments

Comments
 (0)