Skip to content

zy839971925-zyy/Agent--deep-research-Workflow-Skills / skills/reasoning-workflow

reasoning-workflow

Verified

Default silent workflow for everyday questions, research, writing, design and engineering. Match effort to the request, resolve costly ambiguity, find specialist resources and verify the requested outcome. Explicitly selectable with “调用我的 workflow skills”.

FileKindSize
CHANGELOG.mdmarkdown10.2 KB
LICENSE.txtmarkdown1.0 KB
README.mdmarkdown3.0 KB
RELEASE.jsonconfig509 B
SHA256SUMSother17.9 KB
SKILL.mdskill md5.4 KB
TEST_REPORT.mdmarkdown11.4 KB
UPGRADE.mdmarkdown13.1 KB
agents/openai.yamlconfig386 B
assets/icon.svgother3.1 KB
docs/BUILD_SOURCE_COMPARISON.jsonconfig25.1 KB
docs/BUILD_SOURCE_COMPARISON_2.1.1.jsonconfig6.0 KB
docs/LEGACY_ENTRY.mdmarkdown17.2 KB
docs/MAIN_INTEGRATION.mdmarkdown3.3 KB
docs/PACKAGE_VALIDATION.jsonconfig412 B
docs/PACKAGE_VALIDATION_2.1_BASELINE.jsonconfig316 B
docs/PATCH_2.1.1.diffother48.3 KB
docs/RELEASE_2.1.1.zh-CN.mdmarkdown7.5 KB
docs/RELEASE_2.2.0.zh-CN.mdmarkdown3.7 KB
docs/RELEASE_3.0.0.zh-CN.mdmarkdown8.4 KB
docs/RELEASE_3.0.1.mdmarkdown824 B
docs/RELEASE_3.0.1.zh-CN.mdmarkdown699 B
docs/RELEASE_3.1.0.mdmarkdown770 B
docs/RELEASE_3.1.0.zh-CN.mdmarkdown808 B
docs/RELEASE_3.2.0.mdmarkdown3.2 KB
docs/TECHNICAL_ARCHITECTURE.mdmarkdown13.4 KB
docs/TECHNICAL_ARCHITECTURE.zh-CN.mdmarkdown11.8 KB
docs/TEST_REPORT_2.1_BASELINE.mdmarkdown4.6 KB
evals/cross_task_cases.jsonconfig21.7 KB
evals/fixtures/architecture-project/README.mdmarkdown598 B
evals/fixtures/architecture-project/src/export.pyscript251 B
evals/fixtures/architecture-project/src/storage.pyscript538 B
evals/fixtures/architecture-project/tests/test_storage.pyscript374 B
evals/fixtures/checkpoint-evidence-mismatch/archive/recommendation-v1.mdmarkdown429 B
evals/fixtures/checkpoint-evidence-mismatch/deliverables/recommendation.mdmarkdown521 B
evals/fixtures/checkpoint-evidence-mismatch/state/checkpoint.mdmarkdown1.1 KB
evals/fixtures/checkpoint-evidence-mismatch/verification/acceptance-review.jsonconfig1.1 KB
evals/fixtures/dependency-resume/completed/local-export-analysis.mdmarkdown412 B
evals/fixtures/dependency-resume/drafts/privacy-section.mdmarkdown144 B
evals/fixtures/dependency-resume/drafts/provider-sync.mdmarkdown196 B
evals/fixtures/dependency-resume/drafts/recovery-section.mdmarkdown158 B
evals/fixtures/dependency-resume/materials/provider-key-management-v2.mdmarkdown569 B
evals/fixtures/dependency-resume/state/checkpoint.mdmarkdown1.3 KB
evals/fixtures/dependency-resume/state/dependency-map.mdmarkdown671 B
evals/fixtures/long-horizon-workspace/archive/docs/sync-options.mdmarkdown247 B
evals/fixtures/long-horizon-workspace/notes/unrelated-ai-scheduler.mdmarkdown209 B
evals/fixtures/long-horizon-workspace/research/architecture/sync-options.mdmarkdown926 B
evals/fixtures/long-horizon-workspace/state/checkpoint.mdmarkdown1.2 KB
evals/fixtures/qualitative-interview-mixed-views.jsonconfig2.3 KB
evals/fixtures/root-cancellation-late-result/README.mdmarkdown249 B
evals/fixtures/root-cancellation-late-result/state/root.jsonconfig222 B
evals/fixtures/root-cancellation-late-result/worker/draft.mdmarkdown136 B
evals/fixtures/root-cancellation-late-result/worker/late-result.jsonconfig233 B
evals/fixtures/runtime-revision-mismatch/README.mdmarkdown417 B
evals/fixtures/runtime-revision-mismatch/artifacts/recommendation-draft.mdmarkdown280 B
evals/fixtures/runtime-revision-mismatch/state/checkpoint.jsonconfig878 B
evals/fixtures/runtime-revision-mismatch/state/current-environment.jsonconfig399 B
evals/fixtures/runtime-revision-mismatch/state/dependency-map.jsonconfig516 B
evals/fixtures/search-yield-control.jsonconfig2.1 KB
evals/v3-functional-scenarios.mdmarkdown34.5 KB
families/audit-verification.mdmarkdown1.1 KB
families/core-reasoning.mdmarkdown2.0 KB
families/decision-analysis.mdmarkdown698 B
families/deep-research.mdmarkdown2.2 KB
families/execution-control.mdmarkdown1.5 KB
families/workflow-learning.mdmarkdown500 B
meta/README.mdmarkdown26.7 KB
meta/README.zh-CN.mdmarkdown26.4 KB
references/change-governance-and-effectiveness.mdmarkdown12.0 KB
references/clarification-gate.mdmarkdown6.9 KB
references/comparative-synthesis.mdmarkdown3.2 KB
references/decision-and-recommendation.mdmarkdown6.6 KB
references/domain-patterns.mdmarkdown4.2 KB
references/engineering-delivery.mdmarkdown2.8 KB
references/evidence-and-provenance.mdmarkdown7.3 KB
references/formal-review-and-audit.mdmarkdown7.4 KB
references/harness-integration.mdmarkdown7.5 KB
references/harness-profiles.mdmarkdown11.8 KB
references/host-adapter.mdmarkdown11.8 KB
references/human-context-and-interpretation.mdmarkdown3.9 KB
references/hypotheses-and-bias-control.mdmarkdown6.2 KB
references/information-target-navigation.mdmarkdown7.4 KB
references/inquiry-and-research.mdmarkdown9.1 KB
references/measurement-and-operationalization.mdmarkdown3.1 KB
references/model-adaptation.mdmarkdown7.5 KB
references/multimodal-and-data.mdmarkdown3.4 KB
references/problem-framing-and-effort.mdmarkdown8.6 KB
references/reasoning-structure-and-decomposition.mdmarkdown5.5 KB
references/relationships-and-systems.mdmarkdown4.2 KB
references/research-modes-and-methods.mdmarkdown17.1 KB
references/research-to-report.mdmarkdown3.8 KB
references/retrieval-and-observation.mdmarkdown14.4 KB
references/runtime-and-delegation.mdmarkdown8.9 KB
references/semantic-state-contract.mdmarkdown5.7 KB
references/specialist-resources.mdmarkdown2.8 KB
references/state-model-and-invariants.mdmarkdown7.1 KB
references/synchronization-and-recovery.mdmarkdown9.6 KB
references/synthesis-execution-and-verification.mdmarkdown6.7 KB
references/task-strategies.mdmarkdown4.9 KB
references/time-scenarios-and-forecasting.mdmarkdown3.6 KB
references/traceability-and-integrity.mdmarkdown6.2 KB
references/ultra-research.mdmarkdown9.1 KB
references/worked-examples.mdmarkdown5.1 KB
references/workflow-learning-and-capa.mdmarkdown4.4 KB
references/writing-for-the-reader.mdmarkdown1.7 KB
routing-index.jsonconfig18.0 KB
schemas/capability-snapshot.schema.jsonconfig1.1 KB
schemas/checkpoint-manifest.schema.jsonconfig5.6 KB
schemas/delivery-manifest.schema.jsonconfig4.9 KB
schemas/dual-verification.schema.jsonconfig2.6 KB
schemas/edge-policy.jsonconfig3.8 KB
schemas/event.schema.jsonconfig1.9 KB
schemas/execution-node-state.schema.jsonconfig2.7 KB
schemas/execution-plan.schema.jsonconfig5.7 KB
schemas/execution-schedule.schema.jsonconfig3.7 KB
schemas/learning-record.schema.jsonconfig4.5 KB
schemas/raw-record.schema.jsonconfig3.3 KB
schemas/review-bundle.schema.jsonconfig1.6 KB
schemas/task-profile.schema.jsonconfig4.2 KB
schemas/work-state.schema.jsonconfig90.9 KB
schemas/worker-proposal.schema.jsonconfig3.1 KB
scripts/build_distribution.pyscript1.7 KB
scripts/check_report_evidence.pyscript3.6 KB
scripts/harness_bridge.pyscript9.2 KB
scripts/host_adapter.pyscript2.1 KB
scripts/learning_core.pyscript6.3 KB
scripts/prepare_task.pyscript2.6 KB
scripts/reference_core.pyscript1.4 KB
scripts/requirements.txtmanifest37 B
scripts/retrieve_learnings.pyscript1.6 KB
scripts/route_resources.pyscript4.1 KB
scripts/route_task.pyscript1.0 KB
scripts/routing_core.pyscript6.5 KB
scripts/runtime_core.pyscript36.4 KB
scripts/semantic_core.pyscript14.9 KB
scripts/validate_delivery.pyexecutablescript10.4 KB
scripts/validate_dual_verification.pyscript3.1 KB
scripts/validate_events.pyscript2.8 KB
scripts/validate_learning.pyscript718 B
scripts/validate_raw.pyscript3.0 KB
scripts/validate_runtime.pyexecutablescript2.5 KB
scripts/validate_state.pyexecutablescript3.3 KB
scripts/validate_workflow.pyscript9.0 KB
tests/audit_repro/adversarial_probes.pyscript6.9 KB
tests/audit_repro/original_2.1_observations.jsonconfig4.4 KB
tests/check_package.pyscript6.1 KB
tests/fixtures/R2-orthogonal-gap-missing-family_profile.jsonconfig464 B
tests/fixtures/R4-light-action-governance-reference-filter_profile.jsonconfig450 B
tests/fixtures/R4-light-high-consequence-reference-filter_profile.jsonconfig482 B
tests/fixtures/answer.txtmarkdown21 B
tests/fixtures/baseline_manifest.jsonconfig871 B
tests/fixtures/baseline_state.jsonconfig2.3 KB
tests/fixtures/causal-search-source-pack.jsonconfig4.9 KB
tests/fixtures/failed_review_record.jsonconfig498 B
tests/fixtures/hybrid_two_cycle_input.jsonconfig1.9 KB
tests/fixtures/learning_intrinsic_flag_false.jsonconfig692 B
tests/fixtures/legal_parallel_independent_input.jsonconfig1.9 KB
tests/fixtures/mixed_plan_schedule_cycle_input.jsonconfig1.9 KB
tests/fixtures/old_answer.txtmarkdown31 B
tests/fixtures/parallel_self_cycle_input.jsonconfig1.2 KB
tests/fixtures/parallel_two_cycle_input.jsonconfig1.9 KB
tests/fixtures/resume_safe_cancelled_input.jsonconfig2.1 KB
tests/fixtures/single_review_record.jsonconfig297 B
tests/fixtures/standard_profile.jsonconfig427 B
tests/fixtures/ultra_delegated_profile.jsonconfig469 B
tests/results/cli_receipts.jsonconfig28.3 KB
tests/results/cli_receipts_2_1_1.jsonconfig35.8 KB
tests/results/independent_tamper_recheck.jsonconfig373 B
tests/results/original_probes_after.jsonconfig7.3 KB
tests/results/regression_2_1_1.logother8.0 KB
tests/results/summary.jsonconfig239 B
tests/results/summary_2_1_1.jsonconfig306 B
tests/run_all.pyscript2.0 KB
tests/run_regression.pyscript38.6 KB
tests/test_2_1_1.pyscript12.0 KB
tests/test_3_2.pyscript4.1 KB
tests/test_harness_bridge_reconciliation.pyscript6.9 KB

docs/RELEASE_2.1.1.zh-CN.md

View on GitHub
# Reasoning Workflow 2.1.1:修复与升级说明

2026-10-21 · 原独立修订包记录;main 集成差异见 [MAIN_INTEGRATION.md](MAIN_INTEGRATION.md)。不自动安装。

## 结论

2.1 的短入口、按需加载和通用任务策略保留。这次集中补上五处已复现的执行/校验缺口,增加两个衔接功能,不另造状态引擎,也不把简单问题变成必须登记的工程流程。Ultra 研究正文保持原有内容;这里没有用“增加篇幅”冒充研究能力提升。

项目初衷仍按 GitHub README:从问题和下一行动出发,合理投入,追到实际结果;不固定 SOP、来源数量或 Agent 阵容。README 对照基线为 `zy839971925-zyy/Agent--deep-research-Workflow-Skills`,审查时 commit `7d4b31f37aa95fac1b05003b626b9fccea60abaa`,该独立包生成时没有向仓库提交;随后经用户明确授权集成至 main,当前状态以仓库根 README 为准。

## 五处修复

1. 审查失效追踪:指纹现在覆盖单数、复数引用与传递依赖,包括 relationship 的 `from_ref`/`to_ref`;环路可终止,缺失引用、重复 ID 拒绝通过。修改关系指向的 observation 后,旧审查不能继续领取有效信用。仅跳过 `verification_refs` 的反向审查遍历,避免把 review 自己带回目标;字段本身仍参与目标字节指纹。
2. 跨 lane 交付义务:Question、Action、Mixed 都检查显式 material requirement/acceptance 等义务。状态与 manifest 一致地写 blocked,仍然是未完成,不再因为 Question lane 就判可完整交付。
3. 禁止并行:不再依赖可省略的 `concurrency_group` 标签。parallel/hybrid 下,forbidden 节点必须由实际依赖或 `starts_after` 链与其他节点错开;未知引用和等待环拒绝。合法独立任务仍可并行,串行/有序混合控制例通过。它是调度声明校验,不是已运行的外部调度器。
4. Ultra 方法可达:Ultra 路由必带 `required_reference_ids=["ultra-research"]`,没有 gap tag 也不能漏选。手工删改路由、漏掉必需参考都拒绝;准备入口还检查必需文件确实存在。缺少工具/宿主能力须明确受限或阻塞,不能声称已执行完整 Ultra,也不悄悄降档。
5. 晋升证据:Tier3 的 regression、held-out、baseline、dual-review、rollback 不再只检查字符串非空;需解析存在的宿主证据,检查类型、用途、lesson 范围/内容指纹、current/pass 及文件哈希。dual review 还需独立性证据标签由宿主核实。Tier2 held-out 也补了同一门槛。普通检索仍仅 Tier1;maintenance 的 Tier2/3 仍只是建议,不自动改写 Skill。

## 两项功能完善

### 一步准备,但不代替执行

可选 `scripts/prepare_task.py` 串接 profile 规范化 → 确定性路由 → 必需资源选择 → 本地路径检查;给出本阶段参考、因阶段容量延后的 gap 参考和明确阻塞原因。它不调用外部服务,不授予权限,不假报模型已读取或任务已执行。简单 Light 控制例保持零参考加载;简单任务根本不必生成 profile。

```sh
uv run --no-project --with jsonschema==4.23.0 python scripts/prepare_task.py \
  tests/fixtures/standard_profile.json --signal ultra_requested
```

输出 `task_executed=false`、`authority_granted=false` 是预期边界,不是故障。模型/宿主仍需真正读取参考、执行可用工具、验证和交付。

### 可以诚实交付阶段性结果

manifest 可用 `delivery_kind="partial"`,并提供非空 `remaining_work`、`remaining_obligation_refs` 和 `declared_delivery_ready=false`。未解决的 material requirement/acceptance ID 不能漏报;canonical task 也不能标 closed/ready。文件和状态一致性检查仍照常生效。

`computed_partial_ready=true` 仅表示阶段性交接在结构上可接受;`computed_delivery_ready` 和 `computed_task_complete` 仍为 false。不会因此关闭根目标,也不会自动保存进度或安排重试。保留可用中间结果,和声称最终完成,是两件事。

## 升级办法与兼容边界

- 解压后保留整个 `Reasoning Workflow/`,将根 `SKILL.md` 作为入口;不要只复制脚本或 references。保留旧 2.1 目录作回退。此包没有安装脚本,没有自动连接/改设置。
- 不必迁移无关状态;需要继续的记录使用当前规范化 profile 重新生成 route,不能把旧 route 改一个版本号凑用。
- 指纹依赖闭包变化,受影响旧目标要重新计算指纹并重新审查,不能给旧 review 擅自换 hash 当新审查。
- 旧 manifest 不写 `delivery_kind` 时仍按完整交付处理。此前靠 Question lane 漏检才过关的记录会被挡住;这属于修正,不以删去义务“兼容”。
- 旧 Tier2/3 晋升 resolver 若只接受 `resolver(ref)`,现在必须实现 `resolver(ref, role=..., record=...)`;旧 Tier1 通用证据调用仍兼容。宿主 index 的新字段和证据类型见 [host adapter](../references/host-adapter.md#learning-evidence-admission)。没有可信宿主,不能把自行填写的 JSON 当认证证据。
- 并行组名不建立隔离或时间顺序;原本实际串行的工作应声明 serial 或正确的依赖/等待关系。不会自动重排或执行真实任务。
- 先检查 `SHA256SUMS`,再运行测试。测试会重写 `tests/results/` 的运行回执,因此重跑后的这些文件可能不再等于发布包的原始哈希;这不等于原下载包损坏。

## 实测结果与复现

原版 39 项回归完整保留,新增 30 项;最终组合运行 69 项、0 failure、0 error,其中 38 次真实 CLI 子进程调用。新增覆盖关系端点/传递环、缺失引用、跨 lane 阻塞、partial 误报/漏报、无标签/异组并发绕过、合法串行/独立并发、Ultra 漏资源/篡改 route、晋升证据类型/范围/过期/字节篡改,以及入口到资源衔接。

```sh
uv run --no-project --with jsonschema==4.23.0 python tests/run_all.py
# 如只复查原有39项:
uv run --no-project --with jsonschema==4.23.0 python tests/run_regression.py
# 原审查反例另行重跑(参数由该脚本提供):
uv run --no-project --with jsonschema==4.23.0 python tests/audit_repro/adversarial_probes.py \
  --skill "$PWD" --output /tmp/workflow-probes.json
```

机器回执见 [测试汇总](../tests/results/summary_2_1_1.json)、[CLI 回执](../tests/results/cli_receipts_2_1_1.json) 和 [原反例修复后结果](../tests/results/original_probes_after.json)。跨模块 bridge 的合法/失败控制、恢复拒绝与宿主边界沿用原套件,新增 entry/partial/晋升 CLI 衔接。

## 仍不能宣称的事

69 项是确定性代码/合成契约测试,不是 69 次模型服从实验。包内六类 cross-task case 仍是协议,不是模型实测。没有第二个独立模型、同模型旧新版盲测、真实外部调度/支付/回滚/持久化集成;不能保证任意模型读完一定执行,不能声称研究正确率、成本或延迟已提升。

文件哈希和证据 index 证明本地字节/绑定,不证明事实、作者身份、独立性或权限。宿主必须认证来源和真实执行。Ultra 在这里的可观察实践是按问题拆分、反例、正向控制、回归和边界检查;没有输出或要求隐藏思维链。

建议下一步是选同一模型/宿主,对短回答、深度调研、文件/代码、协调、恢复和外部行动边界做旧新版成对试验,记录正确完成率、错误完成声明、约束保留和开销。该实验尚未运行,本包未把它写成“已经提升”。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall